A base class for all non-modal sets of related widgets that persist in the interface.
Inherited By : DzAbstractNodeEditorPane, auxviewportpane_dz, contentlibrarypane_dz, drawsettingspane_dz, environmentpane_dz, hierarchypane_dz, measuremetricspane_dz, parameterspane_dz, renderlibrarypane_dz, rendersettingspane_dz, scriptedstepspane_dz, scriptpane_dz, simulationsettingspane_dz, smartcontentpane_dz, surfacespane_dz and viewportmgrpane_dz
|void||buildOptionsMenu ( DzActionMenu menu )|
|void||makeUndockable ( Size minSize=Size )|
|void||moveToGroup ( DzPaneGroup group )|
|void||restoreSettings ( DzPaneSettings settings )|
|void||saveSettings ( DzPaneSettings settings )|
|void||setLabel ( String label )|
|void||undock ( Point pos=Point, Size size=Size )|
|void||undockGroup ( Point pos=Point, Size size=Size )|
A “Pane” is the application's implementation of a persistent non-modal set of closely related widgets that can be stacked, ordered, docked, undocked, minimized, restored, shown, hidden, positioned and/or resized by the end-user.
Each pane has a label that is attached to the outer perimeter of the pane; whether the label appears as a tab/button/etc. to the user depends on the “style” that they currently has applied. A pane's label should briefly describe the concept (product, service, etc.) presented to the user within the pane.
Actions performed by the user that are closely related to the concept of a given pane, but do not warrant a persitent widget within the pane itself, or are more advanced in nature, should be considered for placement with the pane's option menu.
A pane is only ever displayed to the user within a DzPaneGroup; this is what gives the pane its ability to be stacked, ordered, docked, undocked, minimized, restored, shown, hidden, positioned and/or resized. A pane can only ever exist within one DzPaneGroup at a time.
Panes are singletons; there is only one instance of a given DzPane subclass. Panes are registered with DzPaneMgr and are available to access and modifiy via script. Use DzPaneMgr::findPane() to obtain a pointer to the single instance of the subclass, using its classname.
Sub classes must reimplement this function to generate a default options menu if they have one. This function is called when the pane is loaded for the first time or the interface is reset. Otherwise, the option menus are loaded from the user's interface settings file.
Sub classes must reimplement this function to provide the interface manager with the ability to update the user's settings file when the pane's default menu has changed. This function should return a value of 1 or greater if the pane provides a menu. Each time the default menu changes, this number should be incremented.
void : hidePane()
Hides this pane in the interface.
void : makeGroupDockable()
Moves the DzPaneGroup that this pane is in, out of an undockable dialog.
void : makeGroupUndockable()
Moves the DzPaneGroup that this pane resides in to a dialog.
Creates a DzPaneGroup in a dialog, and moves this pane into it.
Moves this pane from its current pane group into the given pane group.
void : refresh()
Called to refresh internal pane data when scene contents, etc have changed.
Sub classes must reimplement this function to restore their saved settings.
Sub classes must reimplement this function to save their current settings.
Sets the label for this pane.
void : showPane()
Shows this pane in the interface.
Creates an undocked DzPaneGroup and moves this pane into it.
Undocks the DzPaneGroup that this pane resides in.
Emitted when the pane's label has changed.
void : menuChanged()
Emitted when the options menu for the pane has changed.
TODO: Add description.
Emitted when the visibility of the pane's tab bar is changed. When the tab bar is hidden, it's options menu is not visible. If desired, pane instances can listen to this signal to know when the menu is hidden in order to provide an alternate method of accessing the menu options.
true, the tab bar is hidden.
Emitted when the pane is shown or hidden.
true, the pane is visible.