4D Doc Center : Select RGB Color

4D v14.3

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プロセス内では、このコマンドを使用しないでください。