Select RGB Color
Select RGB Color {( defaultColor {; message} )} -> 戻り値
引数 | 型 | 説明 | |
---|---|---|---|
defaultColor | 倍長整数 | 🡒 | 事前に選択されたRGBカラー |
message | 文字 | 🡒 | 選択ウィンドウのタイトル |
戻り値 | 倍長整数 | 🡐 | RGBカラー |
説明
Select RGB Colorコマンドはシステムカラー選択ウィンドウを表示し、ユーザによって選択された色のRGB値を返します。
システムカラー選択ウィンドウは以下のように表示されます。
Macintosh | Windows |
---|---|
オプションの引数defaultColor を使用して、色を事前に選択できます。例えばこの引数を使用して、ユーザーが最後に設定した色をデフォルトで復元することができます。RGBのフォーマットカラーの値をこの引数に渡します (OBJECT SET RGB COLORSコマンドの説明参照)。SET RGB COLORSテーマにある定数の一つを使用できます。
引数defaultColorを省略したり0を渡すと、ダイアログボックスが開いたときに黒色が選択されます。
オプションの引数messageを使用して、システムウィンドウのタイトルをカスタマイズできます。この引数が省略されると、タイトル"カラー" がデフォルトで表示されます。
このダイアログボックスを受け入れた後の動作はプラットフォームにより異なります:
- WindowsではユーザーがOKをクリックすると、コマンドから選択された色がRGBフォーマットで返され、OKシステム変数が1に設定されます。ユーザーがダイアログボックスをキャンセルするとコマンドは-1を返し、システム変数OKに0が設定されます。
- Mac OSではクローズボックスをクリックするかEscキーを押してダイアログボックスを閉じます。ダイアログ内でのユーザーの操作に関わらず、いずれの場合もシステム変数OKは1に設定されます。コマンドは選択された色をRGBフォーマットで返します。ユーザーがカラーを選択しなかった場合、返される値はdefaultColorが渡されていればその値、渡されていなければ0です。
注: サーバーマシンまたはWebプロセス内では、このコマンドを使用しないでください。