Main Content

uisetcolor

Open color picker

collapse all in page

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.

example

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.

example

Examples

collapse all

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

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.

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

c =

     0.6000    0.8000    1.0000

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

c = uisetcolor([1 1 0],'Select a color')

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

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

c =

     1     1     0

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

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.

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.

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

Input Arguments

collapse all

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

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 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

collapse all

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

collapse all

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

See Also

| | | | |