4.3. The topToolBars and bottomToolBars child elements of layout

<topToolBars
  insert = non empty token
  replace = non empty token
  replaceEnd = non empty token
>
  Content: [ insert | toolBar | statusBar | tool | group ]+
</topToolBars>

<insert />

<toolBar
  name = NMTOKEN
  stretch = non negative double : 0
/>

<statusBar
  name = NMTOKEN
  stretch = non negative double : 0
/>

<tool
  name = NMTOKEN
  stretch = non negative double : 0
/>

<group
  name = NMTOKEN
>
  Content: [ toolBar | statusBar | tool ]{2,}
</group>

Element topToolBars specifies the list of tools, toolBars and statusBars which will be found above the document views. Element bottomToolBars specifies the list of tools, toolBars and statusBars which will be found below the document views. The tools, toolBars and statusBars referenced in these lists must have been declared in this GUI specification.

Each tool, toolBar or statusBar referenced in topToolBars or in bottomToolBars elements will have its own row. If you want to group several tools, toolBars and statusBars per row, you need to use group elements.

In a group element, an item can be “stretched”, that is, it can be enlarged to fill all the available horizontal space. If several items are to be stretched, the numeric value of the stretch attribute specifies the amount of space given to each of them. An item with a large stretch attribute is given more space than an item with a small stretch attribute.

A group element may have a name attribute. The only use of this name attribute is to make simpler customizing the toolBars element which is the parent of the group element. See Customizing a composite part without redefining it from scratch.

Examples:

    <topToolBars>
      <toolBar name="toolBar" />
      <group name="nodePathToolBar">
        <tool name="nodePathTool" stretch="1" />
        <toolBar name="selectToolBar" />
      </group>
    </topToolBars>

    <bottomToolBars>
      <statusBar name="statusBar" />
    </bottomToolBars>