5.3. The `topToolBars` and `bottomToolBars` child elements of `layout`
Prev | 5. layout | Next

### 5.3. The `topToolBars` and `bottomToolBars` child elements of `layout`

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

    <insert />

    <toolBar
      name = NMTOKEN
    />

    <statusBar
      name = NMTOKEN
    />

    <tool
      name = NMTOKEN
    />

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

    Inside group:

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

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

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

Element `topToolBars` specifies the list of `tool`s, `toolBar`s and `statusBar`s which will be found above the document views. Element `bottomToolBars` specifies the list of `tool`s, `toolBar`s and `statusBar`s 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 `tool`s, `toolBar`s and `statusBar`s 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.

Examples:

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

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

Prev | Up | Next
5.2. The `menuBar` child element of `layout` | Home | 5.4. The `leftToolBars` and `rightToolBars` child elements of `layout`