17. toolBar

<toolBar
  name = NMTOKEN
  helpId = NMTOKEN
>
  Content: ([ insert | action | tool | separator ]+ [ toolBarItems ]?)
           | 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. The reference to the toolBarItems element, if any, must always be the last reference contained in the toolBar element.

The insert child element may be used to extend the previous declaration of the tool bar. Without an insert child element, a new declaration for tool bar "foo" is understood as being a redefinition of tool bar "foo". The insert child element specifies where to insert the items found in the previous declaration. The insert element must be the first or the last child of a toolBar.

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>