<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 elements, the insert
child element also specifies where to insert the references found in the previous definition of these elements. The insert
element must be the first or the last child of these elements.
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>