Syntax of a toolbar file (.4tb)

A .4tb toolbar file is an XML file that holds a tree of elements defining a toolbar structure.

Syntax: XML Toolbar

<ToolBar [ toolbar-attribute="value" [...]] >
  { <ToolBarItem item-attribute="value" [...] />
  | <ToolBarSeparator separator-attribute="value" [...] />
  | <ToolBarAutoItems autoitems-attribute="value" [...] />
  } [...]
</ToolBar>
  1. toolbar-attribute defines a property of the toolbar.
  2. item-attribute defines a property of a toolbar item.
  3. autoitems-attribute defines a property of a toolbar auto-items placeholder.
  4. separator-attribute defines a property of a toolbar separator.

Toolbar XML attributes

Table 1. ToolBar node attributes
Attribute Type Description
style STRING Use to decorate the element with a presentation style.
tag STRING User-defined attribute to identify the node.
name STRING Identifies the toolbar.
buttonTextHidden INTEGER Defines if the text of toolbar buttons must appear by default (0 = visible, 1 = hidden).
Important:

The buttonTextHidden attribute is deprecated for ToolBar elements: Use Toolbar/"aspect" style attribute instead.

Note:

On front-ends where the toolbar button texts can be hidden with an option (context menu), the stored settings take precedence over the BUTTONTEXTHIDDEN attribute.
Table 2. ToolBarItem node attributes
Attribute Type Description
name STRING

Identifies the action corresponding to the toolbar button.

Can be prefixed with the sub-dialog identifier.
style STRING Use to decorate the element with a presentation style.
tag STRING User-defined attribute to identify the node.
text STRING The text to be displayed in the toolbar button.
comment STRING The message to be shown as tooltip when the user selects a toolbar button.
hidden INTEGER Indicates if the item is hidden (0 = visible, 1 = hidden).
image STRING The icon to be used in the toolbar button.
autohide INTEGER When set to 1, indicates that the element must be automatically hidden when corresponding action is disabled.
Table 3. ToolBarAutoItems node attributes
Attribute Type Description
content STRING Defines the type of content for this element. Values can be "actions", "programs" or "windows". This attribute is mandatory!
name STRING Identifies the toolbar separator.
style STRING Use to decorate the element with a presentation style.
tag STRING User-defined attribute to identify the node.
hidden INTEGER Indicates if the auto-item is hidden (0 = visible, 1 = hidden).
Table 4. ToolBarSeparator node attributes
Attribute Type Description
name STRING Identifies the toolbar separator.
style STRING Use to decorate the element with a presentation style.
tag STRING User-defined attribute to identify the node.
hidden INTEGER Indicates if the separator is hidden (0 = visible, 1 = hidden).