toolbar

Allows the definition of a toolbar for a page. A toolbar is a separate and fixed area at the beginning of the page that functions much like a toolbar in a word processing application. Items placed in the toolbar are always visible at the beginning of the form, no matter what portion of the page they are viewing.

The toolbar is visible no matter what portion of the page body is visible. However, if the toolbar is larger than half the form window, it is necessary to scroll to see everything it contains.

Available options

bgcolor, itemnext, itemprevious, mouseover

Example

This example shows a toolbar that contains a label.

Here is the toolbar definition:

   <toolbar sid="TOOL_BAR">
      <bgcolor>cornsilk</bgcolor>
   </toolbar>

Here is the label that will appear in the toolbar.

   <label sid="COMPANY_NAME">
      <value>My Company</value>
      <itemlocation>
         <within>TOOL_BAR</within>
      </itemlocation>
   </label>

Usage details

The default background color of a toolbar is inherited from the background color of the page.
Add items to the toolbar using the within modifier of the itemlocation option. Code the itemlocation option in each included item's definition.
Each page can contain only one toolbar.
If an XForms item is placed in the toolbar, then any items controlled by it are also placed in the toolbar, regardless of individual declarations. For example, if a table were placed in the toolbar, then all items in that table would also appear in the toolbar.