confirmDialog コマンド

概要

confirmDialog [-backgroundColor float float float] [-button string] [-cancelButton string] [-defaultButton string] [-dismissString string] [-message string] [-messageAlign string] [-parent string] [-title string]

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

confirmDialog コマンドは、ユーザに対するメッセージを含むモーダルダイアログと、そのダイアログを却下するための変数のボタンを作成します。このダイアログは、何かボタンを押したとき、またはウィンドウメニューから「閉じる」を選ぶと却下されます。ボタンを押した場合は、選択したボタンの名前が返されます。「閉じる」を選んでダイアログを閉じた場合に返される文字列は、dismissString フラグで指定されます。

引数が指定されていない場合のデフォルト動作は、空の単一のボタンダイアログを作成するように指定されています。

戻り値

string

ダイアログを却下する方法を示します。ボタンを押すと、ボタンのラベルが返されます。ダイアログを閉じると、フラグ dismissString の値が返されます。

フラグ

backgroundColor, button, cancelButton, defaultButton, dismissString, message, messageAlign, parent, title

ロングネーム（ショートネーム） 引数型 プロパティ

-title(-t) string

ダイアログのタイトルです。

-message(-m) string

ダイアログに表示されるメッセージテキストです。

-messageAlign(-ma) string

メッセージを左、中央、または右にアラインします。

-button(-b) string

指定した文字列がテキストとして表示されるボタンを作成します。

-defaultButton(-db) string

Enter キーを押すとデフォルトボタンがアクティブになります。このフラグはボタンを作成するのではなく、button フラグで作成されたボタンのうちどれを Enter キーに対応させるかを指定するだけであることに注意してください。

-cancelButton(-cb) string

Escape キーを押すと取り消しボタンがアクティブになります。このフラグはボタンを作成するのではなく、button フラグで作成されたボタンのうちどれを Esc キーに対応させるかを指定するだけであることに注意してください。

-dismissString(-ds) string

ユーザが Window Manager メニューから「閉じる」を選択すると返される文字列です。このフラグが設定されていない場合は、文字列「dismiss」が返されます。

-parent(-p) string

ダイアログの親ウィンドウを指定します。ダイアログは親ウィンドウの中央に配置され、親ウィンドウの動きにつれて上下します。デフォルトでは、ダイアログは特定のウィンドウにはペアレント化されておらず、画面の中央に配置されます。

-backgroundColor(-bgc) float float float

ダイアログのバックグラウンドカラーです。引数は、赤、緑、青のカラー成分に対応しています。それぞれの成分の値は、0.0～1.0 です（Windows のみのフラグです）。

: コマンドの作成モードで使用可能なフラグ	: コマンドの編集モードで使用可能なフラグ
: コマンドの照会モードで使用可能なフラグ	: 1 つのコマンドで複数回使用可能なフラグ

MEL の例

// Create an empty single button dialog.
//
// +-+----------------+
// |-| Confirm Dialog |
// +------------------+
// |                  |
// +------------------+
// | +--------------+ |
// | |   Confirm    | |
// | +--------------+ |
// +------------------+
//
confirmDialog;

// Create a basic Yes/No dialog.
//
// +-+----------------+
// |-|    Confirm     |
// +------------------+
// |  Are you sure?   |
// +------------------+
// | +-----+  +-----+ |
// | | Yes |  | No  | |
// | +-----+  +-----+ |
// +------------------+
//
confirmDialog -title "Confirm" -message "Are you sure?"
    -button "Yes" -button "No" -defaultButton "Yes"
    -cancelButton "No" -dismissString "No";

コマンド（MEL）	Python バージョン
confirmDialog	カテゴリ: ウィンドウ