Go to: Synopsis. Return value. Flags. MEL examples.

Synopsis

workspaceControl [-checksPlugins boolean] [-close] [-closeCommand script] [-collapse boolean] [-defineTemplate string] [-dockToControl string string] [-dockToMainWindow string boolean] [-dockToPanel string string boolean] [-exists] [-floating boolean] [-height] [-heightProperty string] [-initialHeight int] [-initialWidth int] [-label string] [-loadImmediately boolean] [-minimumWidth boolean] [-raise] [-requiredControl string] [-requiredPlugin string] [-restore] [-retain boolean] [-tabToControl string int] [-uiScript script] [-useTemplate string] [-visible boolean] [-visibleChangeCommand script] [-width] [-widthProperty string] [name]

workspaceControl is undoable, queryable, and editable.

Creates and manages the widget used to host windows in a layout that enables docking and stacking windows together.

Return value

stringFull path name to the control.

In query mode, return type is based on queried flag.

Flags

checksPlugins, close, closeCommand, collapse, defineTemplate, dockToControl, dockToMainWindow, dockToPanel, exists, floating, height, heightProperty, initialHeight, initialWidth, label, loadImmediately, minimumWidth, raise, requiredControl, requiredPlugin, restore, retain, tabToControl, uiScript, useTemplate, visible, visibleChangeCommand, width, widthProperty
Long name (short name) Argument types Properties
-checksPlugins(-cp) boolean createedit
Sets whether the UI (as defined by the uiScript) checks the loaded state of one or more plug-ins in its code. The UI will not be loaded until the auto-loading of plug-ins is complete. Default value is false.
-close(-cl) edit
Closes the workspace control.
-closeCommand(-cc) script createedit
Command that gets executed when the workspace control is closed.
-collapse(-clp) boolean createqueryedit
Collapse or expand the tab widget parent of the workspace control.
-defineTemplate(-dt) string create
Puts the command in a mode where any other flags and args are parsed and added to the command template specified in the argument. They will be used as default arguments in any subsequent invocations of the command when templateName is set as the current template.
-dockToControl(-dtc) string string createedit
Dock this workspace control next to the given control. The first argument is the control name, the second is dock position relative to the control (valid values are: "left", "right", "top", "bottom").
-dockToMainWindow(-dtm) string boolean createedit
Dock this workspace control into the main window. The first argument is dock position along the sides of the main window (valid values are: "left", "right", "top", "bottom"), the second is whether or not the control should be tabbed into the first control found at the dock position.
-dockToPanel(-dtp) string string boolean createedit
Dock this workspace control into the given workspace docking panel. The first argument is the panel name, the second is dock position along the sides of the panel (valid values are: "left", "right", "top", "bottom"), the third is whether or not the control should be tabbed into the first control found at the dock position.
-exists(-ex) create
Returns whether the specified object exists or not. Other flags are ignored.
-floating(-fl) boolean createqueryedit
Whether the workspace control is floating.
-height(-h) query
Query only flag returning the current height of the control.
-heightProperty(-hp) string createqueryedit
Sets height property to the workspace control. Valid values are:
  • fixed - Can not be resized manually and will not be given any extra space while maximizing/dynamic resizing
  • preferred - Can be resized manually but will not be given any extra space while maximizing/dynamic resizing
  • free - Can be resized manually and will be given extra space while maximizing/dynamic resizing

Default: free In query mode returns the current height property of the workspace control.
-initialHeight(-ih) int createedit
The initial height of the workspace control when first shown.
-initialWidth(-iw) int createedit
The initial width of the workspace control when first shown.
-label(-l) string createqueryedit
The label text. The default label is the name of the workspace control.
-loadImmediately(-li) boolean createedit
Sets whether the UI (as defined by the uiScript) will be built immediately on workspace control creation (true) or delayed until the control is actually shown (false). Default value is false.
-minimumWidth(-mw) boolean createqueryedit
Sets the minimum width of control to the initial width. This should be used along with initial width flag.
-raise(-r) queryedit
Whether the workspace control widget is visible and either floating or at the top of its workspace area.
-requiredControl(-rc) string createeditmultiuse
The name of a workspace control that this workspace control needs to be open in order to properly function. This workspace control will not be created if the required control is not open, and will be closed when the required control is closed.
-requiredPlugin(-rp) string createeditmultiuse
The name of a plug-in that needs to be loaded in order to build the workspace control UI.
-restore(-rs) createedit
Restores the control according to the following rules:
  • If collapsed then the control will be expanded
  • If hidden then the control will be shown
  • If minimized then the control will be restored
  • If the control is an inactive tab into a tab group then it will become the active tab
-retain(-rt) boolean create
Sets whether the workspace control is retained (i.e. only hidden) or deleted when closed. Default value is true.
-tabToControl(-ttc) string int createedit
Tab this workspace control into the given control. The first argument is the control name, the second is the index position within the containing tab widget (invalid values mean append).
-uiScript(-ui) script createedit
The specified script will be invoked to build the UI of the workspaceControl. This is a required flag.
-useTemplate(-ut) string create
Forces the command to use a command template other than the current one.
-visible(-vis) boolean createqueryedit
The visible state of the workspace control. A control is created visible by default.
-visibleChangeCommand(-vcc) script createedit
Command that gets executed when visible state of the workspace control changes.
-width(-w) query
Query only flag returning the current width of the control.
-widthProperty(-wp) string createqueryedit
Sets width property to the workspace control. Valid values are:
  • fixed - Can not be resized manually and will not be given any extra space while maximizing/dynamic resizing
  • preferred - Can be resized manually but will not be given any extra space while maximizing/dynamic resizing
  • free - Can be resized manually and will be given extra space while maximizing/dynamic resizing

Default: free In query mode returns the current width property of the workspace control.

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.

MEL examples

string $edUI = "myControl";
workspaceControl -edit -visible false $edUI;