uilamp

创建信号灯组件

语法

lmp = uilamp

lmp = uilamp(parent)

lmp = uilamp(___,Name,Value)

说明

lmp = uilamp 在新图窗窗口中创建一个信号灯，并返回 Lamp 对象。MATLAB^® 调用 uifigure 函数来创建该图窗。

lmp = uilamp(parent) 在指定的父容器中创建信号灯。父容器可以是使用 uifigure 函数创建的 Figure 或其子容器之一。

lmp = uilamp(___,Name,Value) 使用一个或多个名称-值参量指定 Lamp 属性。可将此选项与上述语法中的任何输入参量组合一起使用。

示例

在图窗中创建信号灯

fig = uifigure;
lmp = uilamp(fig);

在面板上创建信号灯

fig = uifigure;
pnl= uipanel(fig);
lmp = uilamp(pnl);

设置和访问信号灯属性

创建默认信号灯。

fig = uifigure;
lmp = uilamp(fig);

确定信号灯的当前颜色。

color = lmp.Color

color =

     0     1     0

MATLAB 返回绿色的 RGB 值。

通过将 Color 属性设置为长名称 'red'，将信号灯的颜色更改为红色。

lmp.Color = 'red';

通过将 Color 属性设置为蓝色的 RGB 三元组，将信号灯的颜色更改为蓝色。

lmp.Color = [0 0 1];

输入参数

parent — 父容器

Figure 对象 (默认) | Tab 对象 | Panel 对象 | ButtonGroup 对象 | GridLayout 对象

父容器，指定为使用 uifigure 函数创建的 Figure 对象或其子容器之一：Tab、Panel、ButtonGroup 或 GridLayout。如果不指定父容器，MATLAB 会调用 uifigure 函数创建新 Figure 对象充当父容器。

名称-值参数

将可选的参量对组指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但参量对组的顺序无关紧要。

示例: uilamp(Color="red") 指定信号灯的颜色为红色。

在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。

示例: uilamp("Color","red") 指定信号灯的颜色为红色。

此处所列的属性只是可用属性中的一部分。有关完整列表，请参阅 Lamp 属性。

Color — 信号灯的颜色

[0 1 0] (默认) | RGB 三元组 | 十六进制颜色代码 | 'r' | 'g' | 'b' | ...

信号灯的颜色，指定为 RGB 三元组、十六进制颜色代码或下表中列出的颜色选项之一。

RGB 三元组和十六进制颜色代码对于指定自定义颜色非常有用。

• RGB 三元组是包含三个元素的行向量，其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于 [0,1] 范围内，例如 [0.4 0.6 0.7]。

• 十六进制颜色代码是字符向量或字符串标量，以井号 (#) 开头，后跟三个或六个十六进制数字，范围可以是 0 到 F。这些值不区分大小写。因此，颜色代码 "#FF8800" 与 "#ff8800"、"#F80" 与 "#f80" 是等效的。

此外，还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。

颜色名称	短名称	RGB 三元组	十六进制颜色代码	外观
"red"	"r"	[1 0 0]	"#FF0000"
"green"	"g"	[0 1 0]	"#00FF00"
"blue"	"b"	[0 0 1]	"#0000FF"
"cyan"	"c"	[0 1 1]	"#00FFFF"
"magenta"	"m"	[1 0 1]	"#FF00FF"
"yellow"	"y"	[1 1 0]	"#FFFF00"
"black"	"k"	[0 0 0]	"#000000"
"white"	"w"	[1 1 1]	"#FFFFFF"

以下是 MATLAB 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。

RGB 三元组	十六进制颜色代码	外观
[0 0.4470 0.7410]	"#0072BD"
[0.8500 0.3250 0.0980]	"#D95319"
[0.9290 0.6940 0.1250]	"#EDB120"
[0.4940 0.1840 0.5560]	"#7E2F8E"
[0.4660 0.6740 0.1880]	"#77AC30"
[0.3010 0.7450 0.9330]	"#4DBEEE"
[0.6350 0.0780 0.1840]	"#A2142F"

数据类型: double | char

Position — 信号灯的位置和大小

[100 100 20 20] (默认) | [left bottom width height]

信号灯的位置和大小，指定为向量 [left bottom width height]。此表介绍该向量中的每个元素。

元素	描述
left	父容器的内部左边缘与信号灯的外部左边缘之间的距离
bottom	父容器的内部下边缘与信号灯的外部下边缘之间的距离
width	信号灯的左右外部边缘之间的距离
height	信号灯的上下外部边缘之间的距离

所有测量值都以像素为单位。

由于纵横比的限制，不能单独更改信号灯的高度和宽度。

Position 值相对于父容器的可绘制区域。可绘制区域是指容器边框内的区域，不包括装饰元素（如菜单栏或标题）所占的区域。

示例: [100 200 20 20]

版本历史记录

在 R2016a 中推出

另请参阅

函数

• uifigure

属性

• Lamp 属性

工具

• App 设计工具