ジャンプ先: 概要. 戻り値.
フラグ. MEL 例.
confirmDialog [-backgroundColor float float
float] [-button string]
[-cancelButton string]
[-defaultButton string]
[-dismissString string]
[-icon string] [-message string] [-messageAlign string] [-parent string] [-title string]
confirmDialog は 「元に戻す」が可能、「照会」が不可能、「編集」が不可能
です。
confirmDialog コマンドは、ユーザに対するメッセージを含むモーダル
ダイアログと、そのダイアログを却下するための変数のボタンを作成します。このダイアログは、何かボタンを押したとき、またはウィンドウ
メニューから「閉じる」を選ぶと却下されます。ボタンを押した場合は、選択したボタンの名前が返されます。「閉じる」を選んでダイアログを閉じた場合に返される文字列は、
dismissString フラグで指定されます。 引数が指定されていない場合のデフォルト動作は、空の単一のボタン
ダイアログを作成するように指定されています。
string |
ダイアログを却下する方法を示します。ボタンを押すと、ボタンのラベルが返されます。ダイアログを閉じると、フラグ
dismissString の値が返されます。 |
backgroundColor, button, cancelButton, defaultButton, dismissString, icon, 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 のみのフラグです)。 |
|
-icon(-icn) |
string |
|
|
ユーザは 4
つの標準アイコン「question」、「information」、「warning」、「critical」のいずれかを指定できます。question
アイコンは、メッセージが質問であることを示します。information
アイコンは、メッセージがただの情報であることを示します。warning
アイコンは、メッセージが警告であるが処理可能なことを示します。critical
アイコンは、メッセージが危機的な問題を伝えていることを示します。アイコン
フラグがない場合は、確認ダイアログにアイコンを含めたくないと判断されます。 |
|
: コマンドの作成モードで使用可能なフラグ |
: コマンドの編集モードで使用可能なフラグ |
: コマンドの照会モードで使用可能なフラグ |
: 1 つのコマンドで複数回使用可能なフラグ |
// Create an empty single button dialog.
//
confirmDialog;
// Create a basic Yes/No dialog.
//
confirmDialog -title "Confirm" -message "Are you sure?"
-button "Yes" -button "No" -defaultButton "Yes"
-cancelButton "No" -dismissString "No";