4.8. The `insert` descendant element of `layout`
Prev | 4. layout | Next

### 4.8. The `insert` descendant element of `layout`

    <insert />

Adding an `insert` element to the `layout` element, or to any of the child elements of `layout` which allows this (topToolBars, bottomToolBars, leftToolBars, rightToolBars , leftPanes, rightPanes, hidden), means that the `layout` is being extended rather than being redefined.

Inside the `layout` element, an `insert` child element simply means that the `layout` is being extended. Its rank as a child is not significant.

Inside the hidden element, an `insert` child element means that the `hidden` is being extended by adding references to those found in the previous definition of this element. The rank of `insert` as a child of `hidden` is not significant.

Inside topToolBars, bottomToolBars, leftToolBars, rightToolBars, leftPanes, rightPanes, hidden elements, the `insert` child element or the `insert` attribute may be used to extend the previous definition of these elements. More information in About the `insert` child element and the `insert` attribute.

Example: change label and icon:

      <layout label="Document Editor" icon="docedit.png">
        <insert />
      </layout>

Example: replace menu bar and add a tool bar at the left of the `leftPanes`:

      <layout>
        <insert />

        <menuBar name="customMenuBar" />

        <leftToolBars>
          <toolBar name="configSpecificToolBar" />
        </leftToolBars>
     </layout>

Example: insert extra tool bar `toolBar2` above the standard status bar:

      <layout>
        <bottomToolBars>
          <toolBar name="toolBar2" />
          <insert />
        </bottomToolBars>
      </layout>

Prev | Up | Next
4.7. The `hidden` child element of `layout` | Home | 5. menu