ColorDialog ダイアログ要素は、カラーダイアログを定義します。

注意: 上記の ColorDialog maplet は、16-bit color を用いて表示されています。ColorDialog 要素の実際の表示は、ディスプレイの色設定に依存します。

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

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

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

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

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

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

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

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

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

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

height = posint 

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

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

OK ボタンがクリックされる際に起こる動作。

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

Cancel ボタンがクリックされる際に起こる動作。

reference = name または string 

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

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

resizable = true または false 

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

title = string または symbol 

カラーダイアログのタイトルバーに現れるテキスト。デフォルトのタイトルは、Select Color です。

value = color specification 

初期状態として選択される色。色の名前、RGBの色構造、または "#RRGGBB" という形の文字列 (ここで各文字の組は 2 桁の 16 進数)を、認識することができます。

width = posint 

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

with(Maplets[Elements]):
maplet := Maplet(ColorDialog['CD1'](
    'onapprove' = Shutdown(['CD1']),
    'oncancel' = Shutdown()
)):
Maplets[Display](maplet);