TOOLBAR section
The TOOLBAR
section defines a toolbar with buttons that are bound to
actions.
Syntax
TOOLBAR [
toolbar-identifier]
[
( toolbar-attribute [
,...]
) ]
{
item
|
placeholder
|
separator
}
[...]
END
- toolbar-identifier defines the name of the toolbar (optional).
- toolbar-attribute is one of:
STYLE
,TAG
,BUTTONTEXTHIDDEN
.
ITEM item-identifier [
( item-attribute [
,...]
) ]
- item-identifier defines the name of the action to bind to, it is mandatory.
- item-attribute is one of:
STYLE
,TAG
,TEXT
,IMAGE
,COMMENT
,HIDDEN
,AUTOHIDE
.
AUTOITEMS ( CONTENT = {
ACTIONS |
PROGRAMS |
WINDOWS }
)
ACTIONS
stands for action views to be rendered for all default action views shown in the action panel.PROGRAMS
stands for the list of current programs displayed by the front-end.WINDOWS
stands for the list of windows created by the current program.
SEPARATOR [
separator-identifier]
[
(separator-attribute [
,...]
)
- separator-identifier defines the name of the separator (optional).
- separator-attribute is one of:
STYLE
,TAG
,HIDDEN
.
Form attributes
AUTOHIDE
, BUTTONTEXTHIDDEN
, COMMENT
, HIDDEN
, IMAGE
, STYLE
, TEXT
, TAG
.
Style attributes
Common: backgroundColor
, border
, fontFamily
, fontSize
, fontStyle
, fontWeight
, textColor
, textDecoration
.
Class-specific: aspect
, itemsAlignment
, position
, scaleIcon
, size
.
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 items can be automatically hidden when the
corresponding action is disabled, by using the AUTOHIDE
attribute for the item.
Toolbar button labels are visible by default. The TOOLBAR
supports the
BUTTONTEXTHIDDEN
attribute to hide the labels of buttons.
TOOLBAR
elements can include AUTOITEMS
place holders, with a
mandatory CONTENT
attribute, to define if the auto-commands must show action views
for the current actions not bound to an explicit action view (CONTENT=ACTIONS
), to
show the list of current running programs (CONTENT=PROGRAMS
), or to show the list
of opened windows of the current program (CONTENT=WINDOWS
).
When the toolbar is displayed in the chromebar (with toolBarPosition="chrome"
style attribute), AUTOITEMS
are
not rendered.
TOOLBAR
elements can get a STYLE
attribute in order to use a
specific rendering and decoration, based on presentation style definitions.
Example
TOOLBAR tb ( STYLE="mystyle" )
ITEM accept ( TEXT="Ok", IMAGE="ok" )
ITEM cancel ( TEXT="Cancel", IMAGE="cancel" )
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" )
SEPARATOR
AUTOITEMS ( CONTENT=ACTIONS )
END