TOOLBAR section

The TOOLBAR section defines a toolbar with buttons that are bound to actions.

Syntax

TOOLBAR [toolbar-identifier] [ ( toolbar-attribute [,...] ) ]
  { ITEM item-identifier  [ ( item-attribute [,...] ) ]
  | SEPARATOR [separator-identifier] [ (separator-attribute [,...] ) ]
  } [...]
END
  1. toolbar-identifier defines the name of the toolbar (optional).
  2. item-identifier defines the name of the action to bind to.
  3. separator-identifier defines the name of the separator (optional).
  4. toolbar-attribute is one of: STYLE, TAG, BUTTONTEXTHIDDEN.
  5. item-attribute is one of: STYLE, TAG, TEXT, IMAGE, COMMENT, HIDDEN.
  6. separator-attribute is one of: STYLE, TAG, HIDDEN.

Form attributes

BUTTONTEXTHIDDEN, COMMENT, HIDDEN, IMAGE, STYLE, TEXT, TAG.

Style attributes

Common: backgroundColor, border, fontFamily, fontSize, fontStyle, fontWeight, localAccelerators, showAcceleratorInToolTip, textColor, textDecoration.

Class-specific: scaleIcon, toolBarTextPosition.

Usage

The TOOLBAR section defines a toolbar in a form.

The TOOLBAR section must appear in the sequence described in form file structure.

The TOOLBAR section is optional.

A TOOLBAR section defines a set of ITEM elements that can be grouped by using a SEPARATOR element. Each ITEM defines a toolbar button associated with an action by name. The SEPARATOR keyword specifies a vertical line.

The toolbar buttons are enabled depending on the actions defined by the current interactive instruction. For example, you can define a toolbar button with the action name "cancel" to bind the toolbar item to this predefined dialog action.

Toolbar button labels are visible by default. The TOOLBAR supports the BUTTONTEXTHIDDEN attribute to hide the labels of buttons.

TOOLBAR elements can get a STYLE attribute in order to use a specific rendering/decoration following presentation style definitions.

Example

TOOLBAR tb ( STYLE="mystyle" )
  ITEM accept ( TEXT="Ok", IMAGE="ok" )
  ITEM cancel ( TEXT="Cancel", IMAGE="cancel" )
  SEPARATOR
  ITEM editcut   -- Gets its decoration from action defaults
  ITEM editcopy  -- Gets its decoration from action defaults
  ITEM editpaste -- Gets its decoration from action defaults
  SEPARATOR ( TAG="lastSeparator")
  ITEM append ( TEXT="Append", IMAGE="add" )
  ITEM update ( TEXT="Update", IMAGE="modify" )
  ITEM delete ( TEXT="Delete", IMAGE="del" )
  ITEM search ( TEXT="Search", IMAGE="find" )
END