このページの内容は最新ではありません。最新版の英語を参照するには、ここをクリックします。

uisetcolor

R2026a

カラー ピッカーを開く

ページ内をすべて折りたたむ

構文

c = uisetcolor
c = uisetcolor(RGB)
c = uisetcolor(obj)
c = uisetcolor(___,title)

説明

c = uisetcolor は、モーダル カラー ピッカーを表示し、選択された色を RGB 3 成分として返します。

c = uisetcolor(RGB) は、既定の色の選択を RGB 3 成分として指定します。

例

c = uisetcolor(obj) は、既定の色の選択を指定されたオブジェクト (Figure など) の色になるように設定します。カラー ピッカーで別の色を選択して [OK] をクリックすると、オブジェクトの色が新しい色に変更されます。オブジェクトには何らかの色の特性を制御するプロパティがなければなりません。たとえば、一部のオブジェクトには Color プロパティや BackgroundColor プロパティがあります。

c = uisetcolor(___,title) は、ダイアログ ボックスのカスタム タイトルを指定します。title は、前述のいずれかの構文で最後の引数として指定します。

例

例

すべて折りたたむ

既定の色として薄い青をもつカラー ピッカーを開きます。

c = uisetcolor([0.6 0.8 1])

Color picker. The window contains images of standard colors, recent colors, and a preview of the default light blue color. There are OK and Cancel buttons at the bottom of the window.

異なる色を選択せずに [OK] をクリックすると、既定の色が返されます。

c =

     0.6000    0.8000    1.0000

既定の色として黄をもつカラー ピッカーを開き、タイトルを Select に設定します。

c = uisetcolor([1 1 0],"Select")

Color picker. The window displays "Select" at the top. The yellow color is selected.

異なる色を選択せずに [OK] をクリックすると、既定の色が返されます。

c =

     1     1     0

R2018b 以降、カスタム色をグラデーションから選択するためのタブがカラー ピッカーに備わります。

カラー ピッカーを開き、右上隅にある [カスタム色] タブをクリックします。

c = uisetcolor

Color picker. The Custom Colors tab is selected. The window displays a box with a color gradient, a color slider, a drop-down with RBG selected, the RGB values of the selected color, and a preview of the selected color.

垂直方向のスライダーを動かして、色空間の対象領域を表示します。次に、色のグラデーションをクリックして色を選択します。[OK] をクリックすると、uisetcolor が選択内容を RGB 3 成分として返します。

Color picker before and after selecting a new color. On the left, selecting a new color using the slider updates the gradient. On the right, selecting a point in the gradient updates the RGB values and the color preview.

c =

     0.4471    0.9020    0.1451

入力引数

すべて折りたたむ

既定の色。RGB 3 成分として指定します。RGB 3 成分は、選択された色の赤、緑、青成分の強度を指定する 3 成分の行ベクトルです。強度値は [0,1] の範囲でなければなりません。

例: c = uisetcolor([1 0 0]) は、既定の色の選択として赤を指定します。

例: c = uisetcolor([0.5 0.5 0.5]) は、既定の色の選択としてグレーを指定します。

データ型: single | double

既定の色のソース オブジェクト。グラフィックス オブジェクトとして指定します。オブジェクトには何らかの色の特性を制御するプロパティがなければなりません。たとえば、一部のオブジェクトには Color プロパティや BackgroundColor プロパティがあります。

例: c = uisetcolor(figure) は、Figure を作成し、既定の色の選択を Figure と同じ色になるように設定します。

ダイアログ ボックスのタイトル。文字ベクトルまたは string スカラーとして指定します。

例: c = uisetcolor('Choose a Color') は、'Choose a Color' をダイアログ ボックスのタイトルとして指定します。

出力引数

すべて折りたたむ

選択された色。次の値のいずれかとして返されます。

  • RGB 3 成分 — ユーザーが [OK] をクリックすると、uisetcolor は選択された色を表す RGB 3 成分として選択内容を返します。RGB 3 成分は、選択された色の赤、緑、青成分の強度を範囲 [0, 1] で指定する 3 成分の行ベクトルです。

  • 0 — ユーザーが [キャンセル] をクリックするかカラー ピッカーを閉じると、uisetcolor は 0 を返します。

詳細

すべて折りたたむ

代替機能

関数 uisetcolor は、カラー ピッカー ダイアログ ボックスを別のウィンドウで起動します。代わりにアプリに組み込まれたカラー ピッカー UI コンポーネントを作成するには、関数 uicolorpicker を使用します。

バージョン履歴

R2006a より前に導入

参考

| | | | |