移動先: 概要 戻り値 フラグ Python の例

概要

window( [string] , [backgroundColor=[float, float, float]], [defineTemplate=string], [docTag=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], [numberOfMenus=boolean], [resizeToFitChildren=boolean], [restoreCommand=script], [retain=boolean], [sizeable=boolean], [title=string], [titleBar=boolean], [titleBarMenu=boolean], [toolbox=boolean], [topEdge=int], [topLeftCorner=[int, int]], [useTemplate=string], [visible=boolean], [width=int], [widthHeight=[int, int]])

注意: オブジェクト名や引数を表す文字列はカンマで区切ります。これは概要には示されていません。

window は「元に戻す」が可能、「照会」が可能、「編集」が可能です。

このコマンドは新しいウィンドウを作成しますが、作成されたウィンドウは非表示のままになります。最も効率的なのは、ウィンドウのエレメントを追加してから showWindow コマンドを使用してウィンドウを可視化する方法です。ウィンドウにはオプションでメニュー バーを付けることができます。また、タイトル バーや最小化/最大化ボタンをオンまたはオフにすることもできます。タイトル バーをオフにすると、最小化/最大化ボタンを使用することはできません。

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

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

戻り値

stringウィンドウの名前。

戻り値の型は照会モードでは照会フラグが基になります。

フラグ

backgroundColor, defineTemplate, docTag, exists, frontWindow, height, iconName, iconify, interactivePlacement, leftEdge, mainWindow, maximizeButton, menuArray, menuBar, menuBarVisible, menuIndex, minimizeButton, minimizeCommand, numberOfMenus, resizeToFitChildren, restoreCommand, retain, sizeable, title, titleBar, titleBarMenu, toolbox, topEdge, topLeftCorner, useTemplate, visible, width, widthHeight
ロング ネーム(ショート ネーム) 引数型 プロパティ
exists(ex) boolean create
指定したオブジェクトが存在するかどうかによって、 true または false を返します。他のフラグは無視されます。
defineTemplate(dt) string create
他の任意のフラグと引数を解析し、かつ引数で指定したコマンド テンプレートに 追加するモードに、コマンドのモードを変更します。 templateName がカレントのテンプレートとして設定されていれば、 その後コマンドが実行されるたびに、この引数がデフォルトの引数として使用されます。
useTemplate(ut) string create
コマンドに、カレント以外のコマンド テンプレートの使用を強制します。
title(t) string createqueryedit
ウィンドウのタイトル。
iconName(iconName) string createqueryedit
ウィンドウのアイコンのタイトル。デフォルトでは、ウィンドウのタイトルと同じです。
sizeable(s) boolean createqueryedit
ウィンドウのサイズをインタラクティブに変更できるようにするかどうかを指定します。
titleBar(tb) boolean createqueryedit
ウィンドウのタイトル バーをオンまたはオフにします。
minimizeButton(mnb) boolean createqueryedit
ウィンドウの最小化ボタンをオンまたはオフにします。
maximizeButton(mxb) boolean createqueryedit
ウィンドウの最大化ボタンをオンまたはオフにします。
menuBar(mb) boolean createquery
ウィンドウに空のメニュー バーを追加します。
toolbox(tlb) boolean createqueryedit
ウィンドウをツールボックス スタイルにします。Windows のみのフラグで、タイトル バーを小さくし、わずかに異なる表示スタイルを使用します。
titleBarMenu(tbm) boolean createqueryedit
タイトル バー メニューをウィンドウのタイトル バーに付けるかどうかを制御します。-tb/titleBar が true のときのみ有効です。Windows のみのフラグで、デフォルトの値は true です。
menuBarVisible(mbv) boolean createqueryedit
メニュー バーの表示/非表示(1 つある場合)。
topEdge(te) int createqueryedit
ウィンドウの上端の位置を指定します。
leftEdge(le) int createqueryedit
ウィンドウの左端の位置を指定します。
topLeftCorner(tlc) [int, int] createqueryedit
ウィンドウの左上隅の位置を指定します。
width(w) int createqueryedit
ウィンドウの幅をピクセル単位で指定します。
height(h) int createqueryedit
ウィンドウの高さをピクセル単位で指定します。
widthHeight(wh) [int, int] createqueryedit
ウィンドウの幅と高さをピクセル単位で指定します。
retain(ret) boolean create
ウィンドウを閉じられた後も保持します。デフォルトでは、ウィンドウは閉じられた際に削除されます。
visible(vis) boolean createqueryedit
ウィンドウを表示するかどうかを指定します。
iconify(i) boolean createqueryedit
ウィンドウをアイコン化するかどうかを指定します。
mainWindow(mw) boolean createqueryedit
アプリケーションのメイン ウィンドウにします。メイン ウィンドウは、Window Manager メニューに「Exit」の項目があります。デフォルトでは最初に作成されたウィンドウがメイン ウィンドウになります。
backgroundColor(bgc) [float, float, float] createedit
ウィンドウの背景のカラーを指定します。引数は、赤、緑、青のカラー成分に対応しています。それぞれの成分の値は、0.0~1.0 です(Windows のみのフラグです)。
resizeToFitChildren(rtf) boolean createqueryedit
ウィンドウ内のコントロールを、ウィンドウの拡大縮小に従ってフィットさせるようにします。
interactivePlacement(ip) boolean create
ウィンドウを手動で配置するようにします。デフォルトではウィンドウは自動的に配置されます。デスクトップをカスタマイズしてすべてのウィンドウを自動配置するように設定すると、これは無効になります。このフラグは Windows システムでは何の効力も持ちません。
minimizeCommand(mnc) script createedit
ウィンドウを最小化(アイコン化)した後にスクリプトが実行されます。
restoreCommand(rc) script createedit
最小化(アイコン化)した状態からウィンドウを復元した後にスクリプトが実行されます。
numberOfMenus(nm) boolean query
ウィンドウのメニュー バーにアタッチされているメニューの数を返します。
menuArray(ma) boolean query
ウィンドウのメニュー バーにあるメニュー名を文字配列として返します。
menuIndex(mi) [string, uint] edit
指定したメニューのインデックスを設定します。
docTag(dtg) string createqueryedit
ウィンドウにタグをアタッチします。
frontWindow(fw) boolean query
前面のウィンドウの名前を返します。注: 任意のウィンドウ名を与える必要があります(ウィンドウが存在している必要はありません)。 前面のウィンドウが定義できない場合、「unknown」を返します。

: コマンドの作成モードで使用可能なフラグ : コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ : タプルまたはリストとして渡された複数の引数を持てるフラグ

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) )