ここで紹介するコマンドを使用すると、スクリプトを一時停止してユーザの入力を取得することができます。複雑なカスタム ユーザ インタフェースを作成する場合は、「インタフェースを作成する」を参照してください。
confirmDialog を使用して質問する
confirmDialog コマンドは、メッセージおよび任意の数のボタンを設定したモーダル ウィンドウを作成します。
このウィンドウは、いずれかのボタンを押すかウィンドウの閉じるボタンをクリックすると消えます。
- メッセージ フラグを使用して、ボタンの上に表示されるテキスト文字列を設定します。
- 各ボタンのタイトル文字列を指定する button フラグを追加します。
- defaultButton フラグを使用して、[Enter]キーに対応するボタンを指定します。
- cancelButton フラグを使用して、[Esc]キーに対応するボタンを指定します。
- ボタンをクリックすると、ボタンの名前が返されます。
- ウィンドウの閉じるボタンをクリックすると、dismissString フラグで指定された文字列が返されます。
confirmDialog -title "Confirm" -message "Are you sure?" -button "OK" -button "Cancel" -defaultButton "OK" -cancelButton "Cancel" -dismissString "Cancel";
fileDialog を使用してファイルを選択できるようにする
fileDialog コマンドは、ファイル オープン ダイアログ ウィンドウを表示します。Maya MEL コマンドのドキュメントで fileDialog を参照してください
- directoryMask フラグを使用して、起動するディレクトリとファイル名フィルタを指定します。このフラグを使用しなければ、ファイル ダイアログは現在のディレクトリで起動します。
文字列にはパス名を含めることはできますが、「*.cc」、「/usr/u/*」などのように、必ずワイルドカードでファイルを指定する必要があります。
- このコマンドは選択されるファイルのパスを返します。また、ファイル ダイアログがキャンセルされた場合には、空の文字列を返します。
fileDialog -directoryMask "*.txt"
promptDialog を使用して文字列を取得する
promptDialog コマンドは、メッセージ、テキスト フィールド、および任意の数のボタンを設定したウィンドウを作成します。Maya MEL コマンドのドキュメントで promptDialog を参照してください。
- title フラグを使用して、ウィンドウのタイトルを設定します。message フラグを使用して、テキスト フィールドとボタンの上に表示される文字列を設定します。
- text フラグを使用して、テキスト フィールドの初期値を設定します。scrollableField フラグを使用して、テキスト フィールドを複数行のスクロール フィールドに変更します。
- 各ボタンのタイトル文字列を指定する button フラグを追加します。
- defaultButton フラグを使用して、[Enter]キーに対応するボタンを指定します。
- cancelButton フラグを使用して、[Esc]キーに対応するボタンを指定します。
- ボタンをクリックすると、ボタンの名前が返されます。
- ウィンドウの閉じるボタンをクリックすると、dismissString フラグで指定された文字列が返されます。
- コマンドが返された後に、query フラグと text フラグを使用して再度このコマンドを実行し、入力されたテキストを取得します。
// Show the dialog box:
string $text;
string $result = `promptDialog
-title "Rename Object"
-message "Enter Name:"
-button "OK" -button "Cancel"
-defaultButton "OK" -cancelButton "Cancel"
-dismissString "Cancel"`;
// Use the command again in query mode to
// get the text:
if ($result == "OK") {
$text = `promptDialog -query -text`;
}