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

概要

progressWindow [-endProgress] [-isCancelled boolean] [-isInterruptable boolean] [-maxValue int] [-minValue int] [-modal boolean] [-progress int] [-showProgressPercentText boolean] [-status string] [-step int] [-title string]

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

progressWindow コマンドは、ステータス メッセージ、グラフィックのプログレス ゲージ、オプションで操作を中断する場合の「キャンセルするには Esc キーを押してください」というメッセージを含むウィンドウを作成します。

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

戻り値

booleanウィンドウの作成に成功した場合 true を返し、ウィンドウが作成できなかった場合(考えられる理由として、すでに 1 つ表示されていた場合など) false を返します。

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

フラグ

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

MEL 例

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

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

     int $amount = 0;

     progressWindow
         -title "Doing Nothing"
         -progress $amount
         -status "Sleeping: 0%"
         -isInterruptable true;

     while (true) {

         // Check if the dialog has been cancelled
         if ( `progressWindow -query -isCancelled` ) break;

         // Check if end condition has been reached
         if ( `progressWindow -query -progress` >= 100 ) break;

         $amount += 5;

         progressWindow -edit
             -progress $amount
             -status ("Sleeping: "+$amount+"%");

         pause -seconds 1;
     }

     progressWindow -endProgress;