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, timepane_dz and viewportmgrpane_dz
|void||buildOptionsMenu ( DzActionMenu menu )|
|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 )|
|void||makeUndockable ( Size minSize=Size )|
|void||labelChanged ( String newLabel )|
|void||paneGroupChanged ( DzPaneGroup oldGroup, DzPaneGroup newGroup )|
|void||tabBarHiddenChanged ( Boolean hidden )|
|void||visibilityChanged ( Boolean onOff )|
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 persistent 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 modify via script. Use DzPaneMgr::findPane() to obtain a pointer to the single instance of the subclass, using its classname.
void : buildOptionsMenu( DzActionMenu menu )
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.
DzActionMenu : getOptionsMenu()
Number : getOptionsMenuVersion()
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 : moveToGroup( DzPaneGroup group )
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.
void : restoreSettings( DzPaneSettings settings )
Sub classes must reimplement this function to restore their saved settings.
void : saveSettings( DzPaneSettings settings )
Sub classes must reimplement this function to save their current settings.
void : setLabel( String label )
Sets the label for this pane.
void : showPane()
Shows this pane in the interface.
void : undock( Point pos=Point, Size size=Size )
Creates an undocked DzPaneGroup and moves this pane into it.
void : undockGroup( Point pos=Point, Size size=Size )
Undocks the DzPaneGroup that this pane resides in.
void : makeGroupUndockable()
Exists only to keep old code working. Do not use in new code. Use undockGroup() instead.
void : makeUndockable( Size minSize=Size )
Exists only to keep old code working. Do not use in new code. Use undock() instead.
void : makeGroupDockable()
Exists only to keep old code working. Do not use in new code.
void : labelChanged( String newLabel )
Emitted when the pane's label has changed.
void : menuChanged()
Emitted when the options menu for the pane has changed.
void : paneGroupChanged( DzPaneGroup oldGroup, DzPaneGroup newGroup )
Emitted when the the group the pane is in has changed.
void : tabBarHiddenChanged( Boolean hidden )
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.
void : visibilityChanged( Boolean onOff )
Emitted when the pane is shown or hidden.
true, the pane is visible.