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

Synopsis

windowPref [-enableAll boolean] [-exists] [-height int] [-leftEdge int] [-loadAll] [-maximized boolean] [-parentMain boolean] [-remove] [-removeAll] [-restoreMainWindowState string] [-saveAll] [-saveMainWindowState string] [-topEdge int] [-topLeftCorner int int] [-width int] [-widthHeight int int] string

windowPref is undoable, queryable, and editable.

Create or modify preferred window attributes. The size and position of a window is retained during and between application sessions. A default window preference is created when a window is closed. Window preferences must be named and, consequently, only affect the window with a matching name.

Note that window preferences are not applied to the main Maya window nor the Command window.

Return value

None

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

Flags

enableAll, exists, height, leftEdge, loadAll, maximized, parentMain, remove, removeAll, restoreMainWindowState, saveAll, saveMainWindowState, topEdge, topLeftCorner, width, widthHeight
Long name (short name) Argument types Properties
-enableAll(-ea) boolean createquery
Enable/disable all window preferences. Preferences are enabled by default. Set this flag to false and window's will ignore all preference values.
-exists(-ex) create
Returns true|false depending upon whether the specified object exists. Other flags are ignored.
-height(-h) int createqueryedit
Height of the window.
-leftEdge(-le) int createqueryedit
Left edge position of the window.
-loadAll(-la) create
Reads in file with window attributes from disk.
-maximized(-max) boolean createqueryedit
Maximize the window.
-parentMain(-pm) boolean createquery
Set whether window is parented to main application window. Windows only.
-remove(-r) create
Remove a window preference.
-removeAll(-ra) create
Remove all window preferences.
-restoreMainWindowState(-rms) string create
Reads in file with main window state (positions of toolbars and dock controls).
-saveAll(-sa) create
Writes out file with window attributes.
-saveMainWindowState(-sms) string create
Writes out file with main window state (positions of toolbars and dock controls).
-topEdge(-te) int createqueryedit
Top edge position of the window.
-topLeftCorner(-tlc) int int createqueryedit
Top and left edge position of the window.
-width(-w) int createqueryedit
Width of the window.
-widthHeight(-wh) int int createqueryedit
Width and height of the window.
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

//    Check if the window exists.
//
if (`window -exists ExampleWindow`) deleteUI -window ExampleWindow;

//    Create a window.
//
window ExampleWindow;
columnLayout;
text -label "Size and position the window before closing it.";
button -label "Close" -command ("deleteUI -window ExampleWindow");
showWindow ExampleWindow;

//    When the window is closed a window preference object is
//    created for the window. It has the same name as the window
//    object.
//
windowPref -exists ExampleWindow;

//    Query the window preference size and position.
//
windowPref -query -topLeftCorner ExampleWindow;
windowPref -query -widthHeight ExampleWindow;

//    Create a window with the same name. When it is shown
//    it will be sized and positioned according to the
//    window preference.
//
if (`window -exists ExampleWindow`) deleteUI -window ExampleWindow;
window ExampleWindow;
columnLayout;
text -label "Size and position the window before closing it.";
button -label "Close" -command ("deleteUI -window ExampleWindow");
showWindow ExampleWindow;

//    Delete the window preference and the window will have a
//    default size and position.
//
windowPref -remove ExampleWindow;

//    Create the window one last time.
//
if (`window -exists ExampleWindow`) deleteUI -window ExampleWindow;
window ExampleWindow;
columnLayout;
text -label "Size and position the window before closing it.";
button -label "Close" -command ("deleteUI -window ExampleWindow");
showWindow ExampleWindow;