4.4. The leftToolBars and rightToolBars child elements of layout

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

<insert />

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

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

Element leftToolBars specifies the list of (vertical) toolBars which will be found at the left of the document views. Element rightToolBars specifies the list of (vertical) toolBars which will be found at the right the document views. The toolBars referenced in these lists must have been declared in this GUI specification.

Each toolBar referenced in leftToolBars or in leftToolBars elements will have its own column. If you want to group several toolBars per column, 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 vertical 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.

Example:

    <leftToolBars>
      <toolBar name="myToolBar" />
    </leftToolBars>