uisetcolor

Open color picker

Syntax

c = uisetcolor

c = uisetcolor(RGB)

c = uisetcolor(obj)

c = uisetcolor(___,title)

Description

c = uisetcolor displays a modal color picker and returns the selected color as an RGB triplet.

c = uisetcolor(RGB) specifies the default color selection as an RGB triplet.

c = uisetcolor(obj) sets the default color selection to be the color of the specified object (such as a Figure). If you select a different color in the color picker, the color of the object changes to the new color after you click OK. The object must have a property that controls some aspect of color. For example, some objects have a Color or BackgroundColor property.

c = uisetcolor(___,title) specifies a custom title for the dialog box. Specify the title as the last argument in any of the previous syntaxes.

Examples

Specify the Default Color

Open the color picker with light blue as the default color.

c = uisetcolor([0.6 0.8 1])

Clicking the OK button without selecting a different color returns the default color.

c =

     0.6000    0.8000    1.0000

Specify a Custom Title for the Dialog Box

Open the color picker with yellow as the default color, and set the title to Select.

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

Clicking the OK button without selecting a different color returns the default color.

c =

     1     1     0

Select a Color from a Gradient

Starting in R2018b, the color picker provides a tab for selecting custom colors from a gradient.

Open the color picker, and click the Custom Colors tab in the upper-right corner.

c = uisetcolor

Move the vertical slider to display the desired region of color space. Then click the color gradient to select a color. When you click OK, uisetcolor returns your selection as an RGB triplet.

c =

     0.4471    0.9020    0.1451

Input Arguments

RGB — Default color

[1 1 1] (default) | RGB triplet

Default color, specified as an RGB triplet. An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the selected color. The intensities must be in the range [0,1].

Example: c = uisetcolor([1 0 0]) specifies red as the default color selection.

Example: c = uisetcolor([0.5 0.5 0.5]) specifies gray as the default color selection.

Data Types: single | double

obj — Source object for default color

graphics object

Source object for default color, specified as a graphics object. The object must have a property that controls some aspect of color. For example, some objects have a Color or BackgroundColor property.

Example: c = uisetcolor(figure) creates a Figure and sets the default color selection to be the same color as the figure.

title — Title of dialog box

'Color' (default) | character vector | string scalar

Title of dialog box, specified as a character vector or string scalar.

Example: c = uisetcolor('Choose a Color') specifies 'Choose a Color' as the dialog box title.

Output Arguments

c — Selected color

RGB triplet | 0

Selected color, returned as one of these values:

• RGB triplet — If the user clicks OK, uisetcolor returns the selection as an RGB triplet that represents the selected color. An RGB triplet is a three-element row vector whose elements specify the intensities of the red, green, and blue components of the selected color in the range [0, 1].

• 0 — If the user clicks Cancel or closes the color picker, uisetcolor returns 0.

More About

Modal Window

A modal window is a window that blocks interaction with other windows until the user closes it.

Alternative Functionality

The uisetcolor function launches a color picker dialog box in a separate window. To instead create a color picker UI component that is embedded in an app, use the uicolorpicker function.

Version History

Introduced before R2006a