uisetcolor

打开颜色选择器

全页折叠

语法

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

说明

c = uisetcolor 显示模态颜色选择器，并以 RGB 三元组形式返回所选颜色。

c = uisetcolor(RGB) 指定 RGB 三元组形式的默认颜色选择。

示例

c = uisetcolor(obj) 将默认颜色选择设置为指定对象（例如 Figure）的颜色。如果从颜色选择器中选择不同的颜色，点击确定后，对象的颜色将更改为新颜色。对象必须有一个属性控制颜色的某些方面。例如，某些对象具有 Color 或 BackgroundColor 属性。

c = uisetcolor(___,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.

如果不选择其他颜色而点击确定按钮，将返回默认颜色。

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.

如果不选择其他颜色而点击确定按钮，将返回默认颜色。

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.

移动垂直滑块以显示所需的颜色空间区域。然后点击颜色渐变以选择颜色。点击确定时，uisetcolor 会以 RGB 三元组形式返回所选颜色。

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 三元组。RGB 三元组是包含三个元素的行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度必须处于范围 [0,1] 中。

示例: c = uisetcolor([1 0 0]) 指定红色为默认颜色选择。

示例: c = uisetcolor([0.5 0.5 0.5]) 指定灰色为默认颜色选择。

数据类型: single | double

默认颜色的源对象，指定为图形对象。对象必须有一个属性控制颜色的某些方面。例如，某些对象具有 Color 或 BackgroundColor 属性。

示例: c = uisetcolor(figure) 会创建一个 Figure，并将默认颜色选择设置为与该图窗的颜色相同。

对话框的标题，指定为字符向量或字符串标量。

示例: c = uisetcolor('Choose a Color') 将 'Choose a Color' 指定为对话框标题。

输出参量

全部折叠

选定的颜色，返回为下列值之一：

  • RGB 三元组 - 如果用户点击确定，uisetcolor 会以表示选定颜色的 RGB 三元组形式返回所选内容。RGB 三元组是包含三个元素的行向量，其元素分别指定选定颜色中红、绿、蓝分量在范围 [0, 1] 中的强度。

  • 0 - 如果用户点击取消或关闭颜色选择器，uisetcolor 将返回 0。

详细信息

全部折叠

替代功能

uisetcolor 函数在单独的窗口中启动颜色选择器对话框。要改为创建嵌入到 App 中的颜色选择器 UI 组件，请使用 uicolorpicker 函数。

版本历史记录

在 R2006a 之前推出

另请参阅

| | | | |