windowPref command

概要

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

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

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

ウィンドウのアトリビュートを生成、修正します。ウィンドウのサイズや位置は、アプリケーションのセッションが変わっても維持されます。既定のウィンドウプリファレンスは、ウィンドウを閉じたときに作成されます。ウィンドウのプリファレンスを指定する必要があります。したがって、その名前に一致するウィンドウにしか影響を及ぼしません。

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

戻り値

なし

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

フラグ

enableAll, exists, height, leftEdge, loadAll, maximized, parentMain, remove, removeAll, restoreMainWindowState, saveAll, saveMainWindowState, topEdge, topLeftCorner, width, widthHeight

ロングネーム(ショートネーム) 引数タイプ プロパティ

exists(ex) boolean

指定したオブジェクトが存在するかどうかによって、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) boolean

1 つのウィンドウプリファレンスを除去します。

removeAll(ra) boolean

すべてのウィンドウプリファレンスを除去します。

saveAll(sa) boolean

ウィンドウのアトリビュートをファイルに書き出します。

loadAll(la) boolean

ディスクからウィンドウアトリビュートのファイルを読み込みます。

saveMainWindowState(sms) string

メインウィンドウの状態(ツールボックスとドックコントロールの位置)をファイルに書き出します。

restoreMainWindowState(rms) string

メインウィンドウの状態(ツールボックスとドックコントロールの位置)のファイルを読み込みます。

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

Python 例

import maya.cmds as cmds

#    Check if the window exists.
#
if cmds.window('ExampleWindow', exists=True):
	cmds.deleteUI('ExampleWindow', window=True)

#    Create a window.
#
cmds.window( 'ExampleWindow' )
cmds.columnLayout()
cmds.text( label='Size and position the window before closing it.' )
cmds.button( label='Close', command='cmds.deleteUI("ExampleWindow", window=True)' )
cmds.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.
#
cmds.windowPref( 'ExampleWindow', exists=True )

#    Query the window preference size and position.
#
cmds.windowPref( 'ExampleWindow', query=True, topLeftCorner=True )
cmds.windowPref( 'ExampleWindow', query=True, widthHeight=True )

#    Create a window with the same name. When it is shown
#    it will be sized and positioned according to the
#    window preference.
#
if cmds.window('ExampleWindow', exists=True):
	cmds.deleteUI('ExampleWindow', window=True)

cmds.window( 'ExampleWindow' )
cmds.columnLayout()
cmds.text( label='Size and position the window before closing it.' )
cmds.button( label='Close', command='cmds.deleteUI("ExampleWindow", window=True)' )
cmds.showWindow( 'ExampleWindow' )

#    Delete the window preference and the window will have a
#    default size and position.
#
cmds.windowPref( 'ExampleWindow', remove=True )

#    Create the window one last time.
#
if cmds.window('ExampleWindow', exists=True):
	cmds.deleteUI('ExampleWindow', window=True)

cmds.window( 'ExampleWindow' )
cmds.columnLayout()
cmds.text( label='Size and position the window before closing it.' )
cmds.button( label='Close', command='cmds.deleteUI("ExampleWindow", window=True)' )
cmds.showWindow( 'ExampleWindow' )

コマンド (Python)	MEL バージョン
windowPref	カテゴリ内: ウィンドウ