window

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

概要

window [-backgroundColor float float float] [-closeCommand script] [-defineTemplate string] [-docTag string] [-dockCorner string string] [-dockStation] [-dockingLayout string] [-exists] [-frontWindow] [-height int] [-iconName string] [-iconify boolean] [-interactivePlacement] [-leftEdge int] [-mainWindow] [-maximizeButton boolean] [-menuArray] [-menuBar boolean] [-menuBarCornerWidget string string] [-menuBarResize] [-menuBarVisible boolean] [-menuIndex string uint] [-minimizeButton boolean] [-minimizeCommand script] [-nestedDockingEnabled boolean] [-numberOfMenus] [-parent string] [-resizeToFitChildren boolean] [-restoreCommand script] [-retain] [-sizeable boolean] [-state string] [-title string] [-titleBar boolean] [-titleBarMenu boolean] [-toolbox boolean] [-topEdge int] [-topLeftCorner int int] [-useTemplate string] [-visible boolean] [-width int] [-widthHeight int int] [string]

window は、取り消し可能、照会可能、および編集可能です。

注: ウィンドウには、ボタン、スライダ、フィールドといったコントロールを配置するために使うコントロール レイアウトが必要です。コントロール レイアウトの例としては、columnLayout、formLayout、rowLayout などがあります。

注: このコマンドは uiTemplate コマンドのスタックをクリアします。window コマンドを実行した後に、ウィンドウ テンプレートを設定する必要があります。

戻り値

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

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
-backgroundColor(-bgc)	float float float
ウィンドウのバックグラウンドのカラーを指定します。引数は、赤、緑、青のカラー成分に対応しています。それぞれの成分の値は、0.0～1.0 です。
-closeCommand(-cc)	script
ウィンドウが閉じた後にスクリプトが実行されます。
-defineTemplate(-dt)	string
他の任意のフラグと引数を解析し、かつ引数で指定したコマンド テンプレートに追加するモードに、コマンドのモードを変更します。 templateName が現在のテンプレートとして設定されていれば、その後コマンドが実行されるたびに、この引数が既定の引数として使用されます。
-docTag(-dtg)	string
ウィンドウにタグをアタッチします。
-dockCorner(-dc)	string string
ウィンドウの 4 つのコーナーを占有していたドッキング領域を指定します。既定では、bottom または top のドッキング ウィンドウがウィンドウ全体に広がります。左右のドッキング領域がコーナーを占有できるようにするには、このフラグの複数のインスタンスを使用します。このメソッドには、ドッキングコーナーおよびドッキング領域の 2 つの引数があります。ドッキング コーナーの有効値は「topLeft」、「topRight」、「bottomLeft」、および「bottomRight」です。ドッキング領域の有効値は「left」、「right」、「top」、「bottom」です。
-dockStation(-ds)
このフラグを設定した場合は、このウィンドウに他のドッキング サブウィンドウを含めることができます。
-dockingLayout(-dl)	string
このフラグを照会すると、ドッキング レイアウト情報を含む文字列が返されます。この文字列は、ドッキング ステーションを作成または編集して、直前のドッキング レイアウトを復元する場合に設定できます。この文字列はバイナリ文字列の 16 進数表現であり、可読形式ではありません。ただし、optionVar コマンドを使用してこの文字列を保存し、ロードすることにより、Maya のセッション間でレイアウトを復元することができます。
-exists(-ex)
指定したオブジェクトが存在するかどうかを返します。他のフラグは無視されます。
-frontWindow(-fw)
前面のウィンドウの名前を返します。注: 任意のウィンドウ名を与える必要があります(ウィンドウが存在している必要はありません)。前面のウィンドウが定義できない場合、「unknown」を返します。
-height(-h)	int
ウィンドウ フレームを除くウィンドウの高さをピクセル単位で指定します。
-iconName(-in)	string
ウィンドウのアイコンのタイトル。既定では、ウィンドウのタイトルと同じです。
-iconify(-i)	boolean
ウィンドウをアイコン化するかどうかを指定します。
-interactivePlacement(-ip)
廃止されたフラグです。認識されますが、実装されていません。Maya の将来のバージョンで除去される予定です。
-leftEdge(-le)	int
ウィンドウの左端の位置を指定します。
-mainWindow(-mw)
アプリケーションのメイン ウィンドウにします。メイン ウィンドウは、Window Manager メニューに「Exit」の項目があります。既定では最初に作成されたウィンドウがメイン ウィンドウになります。
-maximizeButton(-mxb)	boolean
ウィンドウの最大化ボタンをオンまたはオフにします。
-menuArray(-ma)
ウィンドウのメニュー バーにあるメニュー名を文字配列として返します。
-menuBar(-mb)	boolean
ウィンドウに空のメニュー バーを追加します。オブジェクトの Qt 名は、m_menubar_nameOfTheWindow になります。
-menuBarCornerWidget(-mcw)	string string
このフラグは親ウィンドウのコーナーに追加するウィジェットを指定します。最初の引数はウィジェット名に、2 番目の引数はウィジェットの位置に対応します。ウィジェットの位置の有効値は、「topLeft」、「topRight」、「bottomLeft」、「bottomRight」です。照会モードの場合、このフラグはすべてのコーナー ウィジェットの名前を topLeft、topRight、bottomLeft、bottomRight の順番で返します。渡されたウィジェット(最初の引数)の changeCommand に -mbr/-menuBarResize フラグを追加して、ウィジェットが常に適切なサイズになるようにします。
-menuBarResize(-mbr)
このフラグは -mcw/-menuBarCornerWidget フラグと一緒に使用する必要があります。このフラグを使用すると、メニュー バーのサイズが変更されて、コーナーのウィジェットが更新されます。
-menuBarVisible(-mbv)	boolean
メニュー バーの表示/非表示(1 つある場合)。
-menuIndex(-mi)	string uint
指定したメニューのインデックスを設定します。
-minimizeButton(-mnb)	boolean
ウィンドウの最小化ボタンをオンまたはオフにします。
-minimizeCommand(-mnc)	script
ウィンドウを最小化(アイコン化)した後にスクリプトが実行されます。
-nestedDockingEnabled(-nde)	boolean
ネストされたドッキングが有効かどうかを制御します。ネストされたドッキングでは、ドッキングされた他のウィンドウの横にドッキング ウィンドウを配置できるため、使用可能な配置スタイルが増えます。
-numberOfMenus(-nm)
ウィンドウのメニュー バーにアタッチされているメニューの数を返します。
-parent(-p)	string
親ウィンドウまたは親レイアウトを指定します。作成したウィンドウは、常にこれらの上に配置されます。注: 親がウィンドウの場合、作成したウィンドウはモーダルでないため、イベントは引き続き親ウィンドウに伝播されます。
-resizeToFitChildren(-rtf)	boolean
ウィンドウ内のコントロールを、ウィンドウの拡大縮小に従ってフィットさせるようにします。
-restoreCommand(-rc)	script
最小化(アイコン化)した状態からウィンドウを復元した後にスクリプトが実行されます。
-retain(-ret)
ウィンドウを閉じられた後も保持します。既定では、ウィンドウは閉じられた際に削除されます。
-sizeable(-s)	boolean
ウィンドウのサイズをインタラクティブに変更できるようにするかどうかを指定します。
-state(-st)	string
このフラグを照会すると、ウィンドウ状態情報を含む文字列が返されます。この文字列はバイナリ文字列の 16 進数表現であり、可読形式ではありません。ただし、optionVar コマンドを使用してこの文字列を保存し、ロードすることにより、Maya のセッション間でウィンドウ状態を復元することができます。
-title(-t)	string
ウィンドウのタイトル。
-titleBar(-tb)	boolean
ウィンドウのタイトル バーをオンまたはオフにします。
-titleBarMenu(-tbm)	boolean
タイトル バー メニューをウィンドウのタイトル バーに付けるかどうかを制御します。-tb/titleBar が true のときのみ有効です。Windows のみのフラグで、既定の値は true です。
-toolbox(-tlb)	boolean
ウィンドウをツールボックス スタイルにします。Windows のみのフラグで、タイトル バーを小さくし、わずかに異なる表示スタイルを使用します。
-topEdge(-te)	int
ウィンドウの上端の位置を指定します。
-topLeftCorner(-tlc)	int int
ウィンドウの左上隅の位置を指定します。
-useTemplate(-ut)	string
コマンドに、現在のものとは異なるコマンド テンプレートを使用するように強制します。
-visible(-vis)	boolean
ウィンドウを表示するかどうかを指定します。
-width(-w)	int
ウィンドウ フレームを除くウィンドウの幅をピクセル単位で指定します。
-widthHeight(-wh)	int int
ウィンドウ フレームを除くウィンドウの幅と高さをピクセル単位で指定します。

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

MEL 例

// Make a new window
//
string $window = `window -title "Long Name"
       -iconName "Short Name"
       -widthHeight 200 55`;
columnLayout -adjustableColumn true;
       button -label "Do Nothing";
       button -label "Close" -command ("deleteUI -window " + $window);
setParent ..;
showWindow $window;

// Resize the main window
//
global string $gMainWindow;
window -edit -widthHeight 900 777 $gMainWindow;

// Make a new window and adjust the docking parameters
// Dock a sub-window into the left area
// set allow nested docking to true to allow for more docking configurations like multiple top rows
// set the dockCorner so  the left dock area occupies the top left corner instead of the top docking area.
//
string $window = `window -title "Long Name"
        -iconName "Short Name"
        -widthHeight 200 55
        -dockStation
        -nestedDockingEnabled true
        -dockCorner "topLeft" "left"`;
columnLayout -adjustableColumn true;
        button -label "Do Nothing";
        button -label "Close" -command ("deleteUI -window " + $window);
setParent ..;
showWindow $window;

string $subWindow = `window`;
string $buttonForm = `formLayout -parent $subWindow`;
button -parent $buttonForm;
dockControl -area "left"
    -content $subWindow
    -allowedArea "left"
    -allowedArea "right"
    -dockStation $window;


// Add a menu to the right of the main window's menu bar.
//
setParent "";
string $menuName = "menuTest";
optionMenu -label "test menu" $menuName;
menuItem -label "item 1" -parent $menuName;
menuItem -label "item 2" -parent $menuName;
menuItem -label "item 3" -parent $menuName;
window -e -menuBarCornerWidget $menuName "topRight" $gMainWindow;