windowPref

ジャンプ先: 概要. 戻り値. フラグ. MEL 例.

概要

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 は、取り消し可能、照会可能、および編集可能です。

ウィンドウのプリファレンスは、Maya メイン ウィンドウにも、コマンド ウィンドウにも適用されないことに注意してください。

戻り値

なし

照会モードでは、戻り値のタイプは照会されたフラグに基づきます。

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
-exists(-ex)
指定したオブジェクトが存在するかどうかによって、true または false を返します。他のフラグは無視されます。
-topEdge(-te)	int
ウィンドウの上端の位置を指定します。
-leftEdge(-le)	int
ウィンドウの左端の位置を指定します。
-topLeftCorner(-tlc)	int int
ウィンドウの上端と左端の位置を指定します。
-width(-w)	int
ウィンドウの幅を指定します。
-height(-h)	int
ウィンドウの高さを指定します。
-widthHeight(-wh)	int int
ウィンドウの幅と高さを指定します。
-maximized(-max)	boolean
ウィンドウを最大化します。
-parentMain(-pm)	boolean
ウィンドウがメイン アプリケーション ウィンドウの親になるかどうかを指定します。Windows のみ。
-enableAll(-ea)	boolean
すべてのウィンドウ プリファレンスを有効化/無効化します。既定では、プリファレンスは有効です。このフラグを無効にすると、ウィンドウではすべてのプリファレンスが無視されます。
-remove(-r)
1 つのウィンドウ プリファレンスを除去します。
-removeAll(-ra)
すべてのウィンドウ プリファレンスを除去します。
-saveAll(-sa)
ウィンドウのアトリビュートをファイルに書き出します。
-loadAll(-la)
ディスクからウィンドウ アトリビュートのファイルを読み込みます。
-saveMainWindowState(-sms)	string
メイン ウィンドウの状態(ツール ボックスとドック コントロールの位置)をファイルに書き出します。
-restoreMainWindowState(-rms)	string
メイン ウィンドウの状態(ツール ボックスとドック コントロールの位置)のファイルを読み込みます。

フラグはコマンドの作成モードで表示できます	フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます	コマンド内でフラグを複数回使用できます。

MEL 例

//    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;