Go to: Synopsis. Return value. Flags. MEL examples.
sceneUIReplacement [-clear] [-deleteRemaining] [-getNextFilter string string] [-getNextPanel string string] [-getNextScriptedPanel string string] [-update string]
sceneUIReplacement is undoable, NOT queryable, and NOT editable.
This command returns existing scene based UI that can be utilized by
the scene that is being loaded. It can also delete any such UI that is
not used by the loading scene.
| string | When used with getNextScriptedPanel, getNextPanel, or getNextFilter |
clear, deleteRemaining, getNextFilter, getNextPanel, getNextScriptedPanel, update
| Long name (short name) |
Argument types |
Properties |
-update(-u)
|
string
|
|
|
Updates the state of the command to reflect the current state
of the application. The string argument is the name of the
main window pane layout holding the panels.
|
|
-clear(-cl)
|
|
|
|
Frees any resources allocated by the command.
|
|
-getNextScriptedPanel(-gsp)
|
string string
|
|
|
Returns the next scripted panel of the specified scripted panel type,
preferably with the specified label.
|
|
-getNextFilter(-gf)
|
string string
|
|
|
Returns the next filter of the specified type with the specified name.
|
|
-getNextPanel(-gp)
|
string string
|
|
|
Returns the next panel of the specified type, preferably with the
specified label.
|
|
-deleteRemaining(-dr)
|
|
|
|
Delete any UI that is scene dependent and has not been referenced by
this command since the last update.
|
|
|
Flag can appear in Create mode of command
|
Flag can appear in Edit mode of command
|
Flag can appear in Query mode of command
|
Flag can be used more than once in a command.
|
// Reset to current state
global string $gMainPane;
sceneUIReplacement -update $gMainPane;
// Try to find the modelPanel named Top View
sceneUIReplacement -getNextPanel "modelPanel" (localizedPanelLabel("Top View"));
// Result: modelPanel1 //
modelPanel -q -label modelPanel1;
// Result: Top View //
// Try to find Front View
sceneUIReplacement -getNextPanel "modelPanel" (localizedPanelLabel("Front View"));
// Result: modelPanel3 //
modelPanel -q -label modelPanel3;
// Result: Front View //
// Is there another Front View? (No: all we find is a model panel called Persp View)
sceneUIReplacement -getNextPanel "modelPanel" (localizedPanelLabel("Front View"));
// Result: modelPanel4
modelPanel -q -label modelPanel4;
// Result: Persp View