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, the insert, replace, replaceEnd attributes may be used to customize the previous definition of these elements. More information in Customizing a composite part without redefining it from scratch.

Example: change label and icon:

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

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

  <layout>
    <menuBar name="customMenuBar" />

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

    <insert />
 </layout>

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

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