window

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

概要

window( [string] , [backgroundColor=[float, float, float]], [closeCommand=script], [defineTemplate=string], [docTag=string], [dockCorner=[string, string]], [dockStation=boolean], [dockingLayout=string], [exists=boolean], [frontWindow=boolean], [height=int], [iconName=string], [iconify=boolean], [interactivePlacement=boolean], [leftEdge=int], [mainWindow=boolean], [maximizeButton=boolean], [menuArray=boolean], [menuBar=boolean], [menuBarVisible=boolean], [menuIndex=[string, uint]], [minimizeButton=boolean], [minimizeCommand=script], [nestedDockingEnabled=boolean], [numberOfMenus=boolean], [parent=string], [resizeToFitChildren=boolean], [restoreCommand=script], [retain=boolean], [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]])

注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。

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)	boolean
このフラグを設定した場合は、このウィンドウに他のドッキング サブウィンドウを含めることができます。
dockingLayout(dl)	string
このフラグを照会すると、ドッキング レイアウト情報を含む文字列が返されます。この文字列は、ドッキング ステーションを作成または編集して、直前のドッキング レイアウトを復元する場合に設定できます。この文字列はバイナリ文字列の 16 進数表現であり、可読形式ではありません。ただし、optionVar コマンドを使用してこの文字列を保存し、ロードすることにより、Maya のセッション間でレイアウトを復元することができます。
exists(ex)	boolean
指定したオブジェクトが存在するかどうかを返します。他のフラグは無視されます。
frontWindow(fw)	boolean
前面のウィンドウの名前を返します。注:任意のウィンドウ名を与える必要があります(ウィンドウが存在している必要はありません)。前面のウィンドウが定義できない場合、「unknown」を返します。
height(h)	int
ウィンドウ フレームを除くウィンドウの高さをピクセル単位で指定します。
iconName(iconName)	string
ウィンドウのアイコンのタイトル。既定では、ウィンドウのタイトルと同じです。
iconify(i)	boolean
ウィンドウをアイコン化するかどうかを指定します。
interactivePlacement(ip)	boolean
廃止されたフラグです。認識されますが、実装されていません。Maya の将来のバージョンで除去される予定です。
leftEdge(le)	int
ウィンドウの左端の位置を指定します。
mainWindow(mw)	boolean
アプリケーションのメイン ウィンドウにします。メイン ウィンドウは、Window Manager メニューに「Exit」の項目があります。既定では最初に作成されたウィンドウがメイン ウィンドウになります。
maximizeButton(mxb)	boolean
ウィンドウの最大化ボタンをオンまたはオフにします。
menuArray(ma)	boolean
ウィンドウのメニュー バーにあるメニュー名を文字配列として返します。
menuBar(mb)	boolean
ウィンドウに空のメニュー バーを追加します。オブジェクトの Qt 名は、m_menubar_nameOfTheWindow になります。
menuBarVisible(mbv)	boolean
メニュー バーの表示/非表示(1 つある場合)。
menuIndex(mi)	[string, uint]
指定したメニューのインデックスを設定します。
minimizeButton(mnb)	boolean
ウィンドウの最小化ボタンをオンまたはオフにします。
minimizeCommand(mnc)	script
ウィンドウを最小化(アイコン化)した後にスクリプトが実行されます。
nestedDockingEnabled(nde)	boolean
ネストされたドッキングが有効かどうかを制御します。ネストされたドッキングでは、ドッキングされた他のウィンドウの横にドッキング ウィンドウを配置できるため、使用可能な配置スタイルが増えます。
numberOfMenus(nm)	boolean
ウィンドウのメニュー バーにアタッチされているメニューの数を返します。
parent(p)	string
親ウィンドウまたは親レイアウトを指定します。作成したウィンドウは、常にこれらの上に配置されます。注: 親がウィンドウの場合、作成したウィンドウはモーダルでないため、イベントは引き続き親ウィンドウに伝播されます。
resizeToFitChildren(rtf)	boolean
ウィンドウ内のコントロールを、ウィンドウの拡大縮小に従ってフィットさせるようにします。
restoreCommand(rc)	script
最小化(アイコン化)した状態からウィンドウを復元した後にスクリプトが実行されます。
retain(ret)	boolean
ウィンドウを閉じられた後も保持します。既定では、ウィンドウは閉じられた際に削除されます。
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]
ウィンドウ フレームを除くウィンドウの幅と高さをピクセル単位で指定します。

フラグはコマンドの作成モードで表示できます	フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます	フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

Python 例

import maya.cmds as cmds

# Make a new window
#
window = cmds.window( title="Long Name", iconName='Short Name', widthHeight=(200, 55) )
cmds.columnLayout( adjustableColumn=True )
cmds.button( label='Do Nothing' )
cmds.button( label='Close', command=('cmds.deleteUI(\"' + window + '\", window=True)') )
cmds.setParent( '..' )
cmds.showWindow( window )

# Resize the main window
#

# This is a workaround to get MEL global variable value in Python
gMainWindow = maya.mel.eval('$tmpVar=$gMainWindow')
cmds.window( gMainWindow, edit=True, widthHeight=(900, 777) )