17. toolBar
Prev | Chapter 4. Reference | Next

## 17. toolBar

    <toolBar
      name = NMTOKEN
      helpId = NMTOKEN
      insert = non empty token
    >
      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 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>

Prev | Up | Next
16. tool | Home | 18. toolBarItems