ConfirmDialog ダイアログ要素は、maplet 内で確認のダイアログを定義します。このダイアログは、表題および、3つのボタン Yes, No および Cancel を含みます。

Maplets のダイアログ要素は、事前に定義されたレイアウトを持っています。ダイアログについては、製作者が要素を指定することはできません。これが、例えばボタンやレイアウト要素といった、他の要素を含むことのできる Window 要素との相違点です。

ConfirmDialog 要素の特徴は、オプションを用いて修正が可能です。Maplets パッケージでのオプション指定を簡単にするために、等式を用いることなしにあるオプションと内容を設定することが可能です。次の表では、(左側の列に) 要素、記号、および型、そして (右側の列に) 型がデフォルトで割り当てられると入力を行う、対応するオプションまたは内容を一覧表示します。

ConfirmDialog 要素は、Action あるいは、onapprove, oncancel および ondecline オプションを指定するコマンド要素を含むことが可能です。

ConfirmDialog 要素は、Maplet 要素の中に含めることが可能です。

次の表に、ConfirmDialog 要素のオプションの、制御および使用法について記述します。

I 列の x は、(要素の定義を行う) 呼び出し手順で指定される、初期化が可能なオプションを示す。

R 列の x は、呼び出し手順で必要となるオプションを示す。

G 列の x は、オプションが Get ツールを用いて取得できる、すなわち読み込み可能であることを示す。

S 列の x は、 SetOption 要素あるいは Set ツールを用いて設定される、書き出し可能なオプションを示す。

opts 引数は、maplet のオプションを設定する、1 つまたは複数の以下の等式を含みます。

caption = string または symbol 

確認のダイアログの本体に現れるテキスト。

height = posint 

ウィンドウの高さ(単位ピクセル)。

onapprove = Action あるいはコマンド要素, または Action 要素の参照(name または string )

ユーザが Yes ボタンをクリックした際に起こる動作。デフォルトでは、この動作でダイアログを閉じます。

oncancel = Action あるいはコマンド要素, または Action 要素の参照(name または string )

ユーザが Cancel ボタンかタイトルバー上にあるダイアログを閉じるボタンのいずれかをクリックした際に起こる動作。デフォルトでは、この動作でダイアログを閉じます。

ondecline = Action あるいはコマンド要素, または Action 要素の参照(name または string )

ユーザが No ボタンをクリックした際に起こる動作。デフォルトでは、この動作でダイアログを閉じます。

reference = name または string 

ConfirmDialog 要素についての参照を表します。

この参照、例えば ConfirmDialog[refID] およびコマンド列内の reference が、両方ともインデックスで指定されている場合、インデックスによる参照が優先されます。

resizable = true または false 

ユーザがウィンドウのサイズ変更を行えるかどうかの設定。デフォルトでは、false です。

title = string または symbol 

確認のダイアログのタイトルバーに現れるテキスト。デフォルトのタイトルは、Confirmation です。

type = `error`, plain, question または warning 

表題に関連するアイコンの表示。デフォルトでは、アイコンを表示しない plain の確認ダイアログが使用されます。

width = posint 

ウィンドウの幅 (単位ピクセル)。

with(Maplets[Elements]):
maplet := Maplet(ConfirmDialog('question', "Is x > 0?",
   'onapprove' = Shutdown("true"),
   'ondecline' = Shutdown("false"),
   'oncancel' = Shutdown("FAIL")
)):
Maplets[Display](maplet);