<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 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>