progressWindow

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

概要

progressWindow([endProgress=boolean], [isCancelled=boolean], [isInterruptable=boolean], [maxValue=int], [minValue=int], [modal=boolean], [progress=int], [showProgressPercentText=boolean], [status=string], [step=int], [title=string])

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

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

一度に表示できるプログレス ウィンドウは、1 つだけです。ウィンドウが可視の間は、ビジー カーソルが表示されます。

戻り値

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

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
endProgress(ep)	boolean
プログレス ウィンドウを終了します。他のフラグとは一緒に使用できません。これは通常、-ic/isCancelled フラグが設定された場合、もしくはプログレス値が最大値になった場合に、MEL を通じて発行されます。
isCancelled(ic)	boolean
操作を解除しようとした場合、true を返します。その他の場合、false を返します。
isInterruptable(ii)	boolean
操作をキャンセルしようとすると、プログレス ウィンドウが反応する場合には、true を返します。true に設定すると、[キャンセル(Cancel)]ボタンが無効になります。
maxValue(max)	int
プログレス インジケータの最大値または「終了」値です。プログレス値が -max/maxValue より大きい場合、プログレス値は最大に設定されます。既定値は 100 です。
minValue(min)	int
プログレス インジケータの最小値または「開始」値です。プログレス値が -min/minValue より小さい場合、プログレス値は最小に設定されます。既定値は 0 です。
modal(mo)	boolean
プログレス ウィンドウをモーダルに設定し、メイン ウィンドウとのインタラクション を防ぎます。
progress(pr)	int
コントロールに現在表示される進捗状況です。値は常に min と max の間になります。既定値は、コントロール作成時の最小値に等しくなります。
showProgressPercentText(spt)	boolean
プログレス ウィンドウにパーセンテージのテキスト ラベルを表示します。
status(st)	string
プログレス ゲージの上に表示される、状況に関するテキストです。
step(s)	int
指定した量の単位で -pr/progress の値を増分します。
title(t)	string
ウィンドウのタイトルです。

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

Python 例

import maya.cmds as cmds

# +-+------------------+
# |-|  Doing Nothing   |
# +--------------------+
# | Sleeping: 40%      |
# |                    |
# | +----------------+ |
# | |||||||          | |
# | +----------------+ |
# |                    |
# | Hit ESC to Cancel  |
# +--------------------+

# Always use the progress dialog from a script, never directly
# from the Script Editor.

amount = 0

cmds.progressWindow(	title='Doing Nothing',
					progress=amount,
					status='Sleeping: 0%',
					isInterruptable=True )
while True :
	# Check if the dialog has been cancelled
	if cmds.progressWindow( query=True, isCancelled=True ) :
		break

	# Check if end condition has been reached
	if cmds.progressWindow( query=True, progress=True ) >= 100 :
		break

	amount += 5

	cmds.progressWindow( edit=True, progress=amount, status=('Sleeping: ' + `amount` + '%' ) )

	cmds.pause( seconds=1 )

cmds.progressWindow(endProgress=1)