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 | ribbon | tool | group ]+
</topToolBars>

<insert />

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

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

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

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

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

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

Each tool, toolBar, statusBar and ribbon referenced in topToolBars or in bottomToolBars elements will have its own row. If you want to group several tools, toolBars, statusBars, ribbons 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>
      <ribbon name="ribbon" />
      <group name="nodePathToolBar">
        <tool name="nodePathTool" stretch="1" />
        <toolBar name="selectToolBar" />
      </group>
    </topToolBars>

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