17. toolBar

<toolBar
  name = NMTOKEN
  helpId = NMTOKEN
  insert = non empty token
>
  Content: [ insert | action | tool | separator | toolBarItems ]+
</toolBar>

<insert />

<action
  name = NMTOKEN
/>

<tool
  name = NMTOKEN
/>

<separator />

<toolBarItems
  name = NMTOKEN
/>

Specifies a tool bar. A tool bar contains references to action, tool and toolBarItems elements declared elsewhere in the GUI specification.

Unless the referenced toolBarItems element has a count attribute, the reference to the toolBarItems element, if any, must be the last reference contained in the toolBar element.

The insert child element or the insert attribute may be used to extend the previous definition of a tool bar. More information in About the insert child element and the insert attribute.

Attributes:

name

Required. Unique name identifying the tool bar in this GUI specification.

helpId

Online help ID of the tool bar.

Example: standard select tool bar:

  <toolBar name="selectToolBar" helpId="selectToolBar">
    <action name="selectParentAction" />
    <action name="selectChildAction" />
    <action name="selectPreviousSiblingAction" />
    <action name="selectNextSiblingAction" />
    <separator />
    <action name="selectXPathAction" />
  </toolBar>

Example: add a separator and tool countWordsTool at the end of the standard select tool bar:

  <toolBar name="selectToolBar">
    <insert />
    <separator />
    <tool name="countWordsTool" />
  </toolBar>