主要内容

LinearGauge属性

控制线性规的外观和性能

线性规是表示测量仪器的UI组件。属性控制线性规的外观和行为。使用点表示法来引用特定的对象和属性。

FIG = ufigure;G = uigauge(图,'linear');g.Value = 45;

全部展开

测量针的位置,指定为任何数值。

  • 如果值小于最小值限制属性值,则指针指向刻度开始之前的位置。

  • 如果该值大于最大值限制属性值,则指针指向刻度结束后的一个位置。

改变了限制属性值对价值属性设置。

例子:60

最小和最大量规刻度值,指定为两个元素的数值数组。数组中的第一个值必须小于第二个值。

如果你改变限制这样价值属性小于新的下限,或大于新的上限,则量规指针指向超出刻度的位置。

例如,假设限制100年[0]价值财产是20。如果限制更改[100],然后指针指向刻度外的一个位置,略小于50。

量规的方向,规定为“水平”“垂直”

缩放颜色,指定为以下数组之一:

  • 1 -n字符串数组的颜色选项,如["蓝" "绿" "红"]

  • 一个n-by-3 RGB三元组数组,例如[0 0 1;1 10 0]

  • 1 -n包含RGB三元组、十六进制颜色代码或命名颜色选项的单元格数组。例如,{' # EDB120 ', ' # 7 e2f8e ', ' # 77 ac30 '}

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

  • RGB三元组是一个三元素行向量,其元素指定颜色的红、绿和蓝分量的强度。强度必须在这个范围内[0, 1];例如,[0.4 0.6 0.7]

  • 十六进制颜色码是字符向量或以散列符号()后面跟着三个或六个十六进制数字,取值范围为0F.这些值不区分大小写。因此,颜色代码“# FF8800”“# ff8800”“# F80”,“# f80”是等价的。

或者,您可以通过名称指定一些常用颜色。该表列出了已命名的颜色选项、等效的RGB三元组和十六进制颜色代码。

颜色名称 短名称 RGB值 十六进制颜色代码 外观
“红色” “r” [10 0 0] “# FF0000”

样品的颜色为红色

“绿色” ‘g’ [0 10 0] “# 00 ff00”

样品的颜色为绿色

“蓝” “b” [0 0 1] “# 0000 ff”

样品的颜色为蓝色

“青色” “c” [0 1 1] “# 00飞行符”

样品的颜色为青色

“红色” “米” [10 0 1] “#就”

样品的颜色为洋红色

“黄色” “y” [11 10 0] “# FFFF00”

样品的颜色为黄色

“黑” “k” [0 0 0] # 000000的

样品颜色为黑色

“白色” ' w ' [1 1 1] “# FFFFFF”

样品颜色为白色

这里是RGB三组和十六进制的颜色代码的默认颜色MATLAB®在许多类型的图中使用。

RGB值 十六进制颜色代码 外观
[0 0.4470 0.7410] “# 0072 bd”

RGB三联体[0 0.4470 0.7410]样品,呈深蓝色

[0.8500 0.3250 0.0980] “# D95319”

RGB三联体样品[0.8500 0.3250 0.0980],呈暗橙色

[0.9290 0.6940 0.1250] “# EDB120”

RGB三联体样品[0.9290 0.6940 0.1250],呈暗黄色

[0.4940 0.1840 0.5560] “# 7 e2f8e”

RGB三联体样品[0.4940 0.1840 0.5560],呈深紫色

[0.4660 0.6740 0.1880] “# 77 ac30”

RGB三联体[0.4660 0.6740 0.1880]样本,呈现中绿色

[0.3010 0.7450 0.9330] “# 4 dbeee”

RGB三联体样品[0.3010 0.7450 0.9330],呈浅蓝色

[0.6350 0.0780 0.1840] “# A2142F”

RGB三联体样品[0.6350 0.0780 0.1840],呈暗红色

每种颜色ScaleColors数组对应于量规的彩色部分。设置ScaleColorLimits属性将颜色映射到量规的特定部分。

如果不设置ScaleColorLimits属性,MATLAB在量规的范围内均匀分布颜色。

缩放颜色限制,指定为n × 2的数值数组。对于数组中的每一行,第一个元素必须小于第二个元素。

在将颜色应用到量规时,MATLAB应用从第一个颜色开始的颜色ScaleColors数组中。因此,如果两行在ScaleColorLimits数组重叠,则稍后应用的颜色优先。

该仪表不显示任何部分的ScaleColorLimits那落在外面的限制财产。

如果ScaleColors而且ScaleColorLimits属性值大小不同,那么量规只显示具有匹配限制的颜色。例如,如果ScaleColors数组有三种颜色,但是ScaleColorLimits只有两行,然后量规只显示前两个颜色/限制对。

蜱虫

全部展开

主要标记位置,指定为数值向量或空向量。如果不希望显示主要标记,请将此属性指定为空向量。

属性范围之外的标记位置限制属性不显示。

MATLAB删除重复的刻度值。但是,如果大刻度与小刻度落在相同的值上,则只显示大刻度。

设置MajorTicks属性设置MajorTicksMode财产“手动”

主要标记创建模式,指定为以下之一:

  • “汽车”MATLAB确定主要刻度的位置。

  • “手动”-指定MajorTicks值数组。

主标记标签,指定为字符向量、字符串数组或1-D分类数组的单元格数组。如果不想显示标记标签,请将此属性指定为空单元格数组。属性中的对应元素指定空字符向量或空字符串标量,即可从特定的标记中删除标签MajorTickLabels数组中。如果将此属性指定为分类数组,MATLAB将使用数组中的值,而不是全部类别集。

如果长度MajorTickLabels数组的长度与MajorTicks矢量,MATLAB忽略长数组的额外元素。如果有额外的标签,它们将被忽略。如果有额外的标记,则显示时不带标签。

设置MajorTickLabels改变了MajorTickLabelsMode价值“手动”

请注意

设置MajorTickLabelsMajorTicksMode“汽车”可能会导致意想不到的结果。若要避免此行为,请设置MajorTicksMode“手动”的值MajorTicks之前的设置MajorTickLabels

主要标记标签模式,指定为以下之一:

  • “汽车”- MATLAB指定主要刻度标签。

  • “手动”参数指定主要的标记标签MajorTickLabels财产。

次要标记位置,指定为数值向量或空向量。如果不希望显示小标记,请将此属性指定为空向量。

属性范围之外的标记位置限制属性不显示。

MATLAB删除重复的刻度值。但是,如果小刻度与大刻度落在相同的值上,则只显示大刻度。

设置MinorTicks属性值设置MinorTicksMode物业价值“手动”

次要标记创建模式,指定为以下之一:

  • “汽车”MATLAB确定小刻度的位置。MATLAB不会为超出规模限制的大刻度生成小刻度。如果限制属性值发生变化,然后MATLAB更新小刻度以填充全刻度范围(即MinorTicks属性将相应地更新)。

  • “手动”-指定MinorTicks属性数值数组。的MinorTicks属性值本身不会改变大小或内容。

字体和颜色

全部展开

字体名称,指定为系统支持的字体名称。金宝app默认字体取决于特定的操作系统和区域设置。

如果指定的字体不可用,MATLAB将使用运行应用程序的系统上可用的字体中的最佳匹配。

例子:“天线”

字体大小,指定为正数。测量单位是像素。默认字体大小取决于特定的操作系统和区域设置。

例子:14

字体权重,指定为以下值之一:

  • “正常”-由特定字体定义的默认重量

  • “大胆”-较粗的字符轮廓“正常”

并非所有字体都有粗体字体粗体。对于没有的字体,指定“大胆”结果显示正常字体粗细。

字体角度,指定为“正常”“斜体”.不是所有字体都有斜体角度。对于没有的字体,指定“斜体”结果字体角度正常。

字体颜色,指定为RGB三元组、十六进制颜色代码或表中列出的选项之一。

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

  • RGB三元组是一个三元素行向量,其元素指定颜色的红、绿和蓝分量的强度。强度必须在这个范围内[0, 1];例如,[0.4 0.6 0.7]

  • 十六进制颜色码是字符向量或以散列符号()后面跟着三个或六个十六进制数字,取值范围为0F.这些值不区分大小写。因此,颜色代码“# FF8800”“# ff8800”“# F80”,“# f80”是等价的。

或者,您可以通过名称指定一些常用颜色。该表列出了已命名的颜色选项、等效的RGB三元组和十六进制颜色代码。

颜色名称 短名称 RGB值 十六进制颜色代码 外观
“红色” “r” [10 0 0] “# FF0000”

样品的颜色为红色

“绿色” ‘g’ [0 10 0] “# 00 ff00”

样品的颜色为绿色

“蓝” “b” [0 0 1] “# 0000 ff”

样品的颜色为蓝色

“青色” “c” [0 1 1] “# 00飞行符”

样品的颜色为青色

“红色” “米” [10 0 1] “#就”

样品的颜色为洋红色

“黄色” “y” [11 10 0] “# FFFF00”

样品的颜色为黄色

“黑” “k” [0 0 0] # 000000的

样品颜色为黑色

“白色” ' w ' [1 1 1] “# FFFFFF”

样品颜色为白色

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

RGB值 十六进制颜色代码 外观
[0 0.4470 0.7410] “# 0072 bd”

RGB三联体[0 0.4470 0.7410]样品,呈深蓝色

[0.8500 0.3250 0.0980] “# D95319”

RGB三联体样品[0.8500 0.3250 0.0980],呈暗橙色

[0.9290 0.6940 0.1250] “# EDB120”

RGB三联体样品[0.9290 0.6940 0.1250],呈暗黄色

[0.4940 0.1840 0.5560] “# 7 e2f8e”

RGB三联体样品[0.4940 0.1840 0.5560],呈深紫色

[0.4660 0.6740 0.1880] “# 77 ac30”

RGB三联体[0.4660 0.6740 0.1880]样本,呈现中绿色

[0.3010 0.7450 0.9330] “# 4 dbeee”

RGB三联体样品[0.3010 0.7450 0.9330],呈浅蓝色

[0.6350 0.0780 0.1840] “# A2142F”

RGB三联体样品[0.6350 0.0780 0.1840],呈暗红色

背景色,指定为RGB三元组、十六进制颜色代码或表中列出的颜色选项之一。

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

  • RGB三元组是一个三元素行向量,其元素指定颜色的红、绿和蓝分量的强度。强度必须在这个范围内[0, 1];例如,[0.4 0.6 0.7]

  • 十六进制颜色码是字符向量或以散列符号()后面跟着三个或六个十六进制数字,取值范围为0F.这些值不区分大小写。因此,颜色代码“# FF8800”“# ff8800”“# F80”,“# f80”是等价的。

或者,您可以通过名称指定一些常用颜色。该表列出了已命名的颜色选项、等效的RGB三元组和十六进制颜色代码。

颜色名称 短名称 RGB值 十六进制颜色代码 外观
“红色” “r” [10 0 0] “# FF0000”

样品的颜色为红色

“绿色” ‘g’ [0 10 0] “# 00 ff00”

样品的颜色为绿色

“蓝” “b” [0 0 1] “# 0000 ff”

样品的颜色为蓝色

“青色” “c” [0 1 1] “# 00飞行符”

样品的颜色为青色

“红色” “米” [10 0 1] “#就”

样品的颜色为洋红色

“黄色” “y” [11 10 0] “# FFFF00”

样品的颜色为黄色

“黑” “k” [0 0 0] # 000000的

样品颜色为黑色

“白色” ' w ' [1 1 1] “# FFFFFF”

样品颜色为白色

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

RGB值 十六进制颜色代码 外观
[0 0.4470 0.7410] “# 0072 bd”

RGB三联体[0 0.4470 0.7410]样品,呈深蓝色

[0.8500 0.3250 0.0980] “# D95319”

RGB三联体样品[0.8500 0.3250 0.0980],呈暗橙色

[0.9290 0.6940 0.1250] “# EDB120”

RGB三联体样品[0.9290 0.6940 0.1250],呈暗黄色

[0.4940 0.1840 0.5560] “# 7 e2f8e”

RGB三联体样品[0.4940 0.1840 0.5560],呈深紫色

[0.4660 0.6740 0.1880] “# 77 ac30”

RGB三联体[0.4660 0.6740 0.1880]样本,呈现中绿色

[0.3010 0.7450 0.9330] “# 4 dbeee”

RGB三联体样品[0.3010 0.7450 0.9330],呈浅蓝色

[0.6350 0.0780 0.1840] “# A2142F”

RGB三联体样品[0.6350 0.0780 0.1840],呈暗红色

交互性

全部展开

可见状态,指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).值为“上”等于真正的,“关闭”等于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState

  • “上”—显示对象。

  • “关闭”—隐藏对象,但不删除对象。您仍然可以访问不可见UI组件的属性。

要使应用程序启动更快,请设置可见财产“关闭”用于所有不需要在启动时出现的UI组件。

压力表的工作状态,说明为“上”“关闭”,或作为数字或逻辑1真正的)或0).值为“上”等于真正的,“关闭”等于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState

  • 如果将此属性设置为“上”,则压力表的外观表明压力表是可操作的。

  • 如果将此属性设置为“关闭”时,则量规外观出现变暗,说明量规不工作。

工具提示,指定为字符向量、字符向量的单元格数组、字符串数组或1-D分类数组。使用此属性可在用户在运行时将指针悬停在组件上时显示一条消息。即使禁用了组件,也会显示工具提示。若要显示多行文本,请指定字符向量的单元格数组或字符串数组。数组中的每个元素都成为一个单独的文本行。如果将此属性指定为分类数组,MATLAB将使用数组中的值,而不是全部类别集。

上下文菜单,指定为快捷菜单对象创建。uicontextmenu函数。使用此属性可在右键单击组件时显示上下文菜单。

位置

全部展开

量规的位置和大小,指定为矢量,[左下宽高].该表描述了向量中的每个元素。

元素 描述
从父容器的左内边缘到量规的左外边缘的距离
从父容器的内底边到量规的外底边的距离
宽度 量规左右外缘之间的距离
高度 量规的顶部和底部外缘之间的距离

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

位置值相对于可拉的区域父容器的。可绘制区域是容器边界内的区域,不包括菜单栏或标题等装饰所占用的区域。

例子:[100 100 100 20]

压力表的内部位置和尺寸,规定为[左下宽高].位置值相对于父容器。所有的测量都以像素为单位。属性值与位置财产。

此属性是只读的。

压力表的外部位置和尺寸,返回为[左下宽高].位置值相对于父容器。所有的测量都以像素为单位。属性值与位置财产。

布局选项,指定为GridLayoutOptions对象。此属性指定网格布局容器的子组件的选项。如果组件不是网格布局容器的子组件(例如,它是图形或面板的子组件),则此属性为空,没有作用。但是,如果组件是网格布局容器的子元素,则可以将组件放置在网格的所需行和列中而且属性GridLayoutOptions对象。

例如,这段代码将一个线性规放在其父网格的第三行和第二列中。

G = uigridlayout([4 3]);Gauge = uigauge(g,“线性”);gauge.Layout.Row = 3;layout . column = 2;

要使量规跨越多行或多列,请指定属性作为两元素向量。例如,这个量规横跨列2通过3.

gauge.Layout.Column = [2 3];

回调

全部展开

对象创建函数,指定为以下值之一:

  • 函数处理。

  • 单元格数组,其中第一个元素是函数句柄。单元格数组中的后续元素是传递给回调函数的参数。

  • 包含有效MATLAB表达式的字符向量(不推荐)。MATLAB在基本工作空间中计算这个表达式。

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见在应用程序设计器中编写回调

此属性指定在MATLAB创建对象时执行的回调函数。函数执行之前,MATLAB初始化所有属性值CreateFcn回调。如果没有指定CreateFcn属性,然后MATLAB执行默认的创建函数。

设置CreateFcn属性在现有组件上不起作用。

如果将此属性指定为函数句柄或单元格数组,则可以使用回调函数的第一个参数访问正在创建的对象。否则,使用gcbo函数来访问对象。

对象删除函数,指定为以下值之一:

  • 函数处理。

  • 单元格数组,其中第一个元素是函数句柄。单元格数组中的后续元素是传递给回调函数的参数。

  • 包含有效MATLAB表达式的字符向量(不推荐)。MATLAB在基本工作空间中计算这个表达式。

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见在应用程序设计器中编写回调

此属性指定在MATLAB删除对象时执行的回调函数。MATLAB执行DeleteFcn在销毁对象的属性之前。如果没有指定DeleteFcn属性,然后MATLAB执行默认删除函数。

如果将此属性指定为函数句柄或单元格数组,则可以使用回调函数的第一个参数访问正在删除的对象。否则,使用gcbo函数来访问对象。

回调执行控制

全部展开

回调中断,指定为“上”“关闭”,或作为数字或逻辑1真正的)或0).值为“上”等于真正的,“关闭”等于.因此,您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState

此属性决定是否可以中断正在运行的回调。有两种回调状态需要考虑:

  • 运行Callback是当前正在执行的Callback。

  • 打断回调是试图中断正在运行的回调的回调。

MATLAB在执行处理回调队列的命令时确定回调中断行为。这些命令包括drawnow数字uifiguregetframe等待,暂停

如果正在运行的回调不包含这些命令之一,则不会发生中断。MATLAB首先完成运行回调的执行,然后再执行中断回调。

如果正在运行的回调包含这些命令之一,则可中断属性决定是否发生中断:

  • 如果的值可中断“关闭”,则不发生中断。相反,BusyAction属性确定中断回调是被丢弃还是添加到回调队列。

  • 如果的值可中断“上”,则中断。下一次MATLAB处理回调队列时,它将停止正在运行的回调的执行,并执行中断的回调。中断回调完成后,MATLAB继续执行正在运行的回调。

请注意

回调中断和执行在以下情况下表现不同:

  • 如果中断回调是DeleteFcnCloseRequestFcn,或SizeChangedFcn回调函数时,中断发生,而不管可中断属性值。

  • 方法当前正在执行等待函数,则中断发生而不管可中断属性值。

  • 如果中断回调属于计时器对象,则回调函数将根据调度执行,而不管可中断属性值。

请注意

当中断发生时,MATLAB不保存属性的状态或显示。方法返回的对象gcagcf命令可能在执行另一个回调时更改。

回调队列,指定为“队列”“取消”.的BusyAction属性决定MATLAB如何处理中断回调的执行。有两种回调状态需要考虑:

  • 运行Callback是当前正在执行的Callback。

  • 打断回调是试图中断正在运行的回调的回调。

BusyAction属性仅在满足以下两个条件时确定回调排队行为:

在这些条件下,BusyAction拥有中断回调的对象的属性决定了MATLAB如何处理中断回调。的可能值BusyAction属性:

  • “队列”—将中断的回调放到队列中,待正在运行的回调执行完成后再处理。

  • “取消”—不执行中断回调。

此属性是只读的。

删除状态,作为类型的on/off逻辑值返回matlab.lang.OnOffSwitchState

MATLAB设置BeingDeleted财产“上”DeleteFcn回调开始执行。的BeingDeleted属性仍然设置为“上”直到组件对象不再存在。

的值BeingDeleted属性在查询或修改对象之前验证对象是否即将被删除。

父/子

全部展开

父容器,指定为数字对象创建。uifigure函数,或者它的子容器之一:选项卡面板ButtonGroup,或GridLayout.如果没有指定容器,MATLAB将调用uifigure函数创建一个新的数字对象,该对象用作父容器。

对象句柄的可见性,指定为“上”“回调”,或“关闭”

此属性控制对象在其父对象的子列表中的可见性。当一个对象在其父对象的子列表中不可见时,通过搜索对象层次结构或查询属性获取对象的函数将不会返回该对象。这些函数包括得到findobjclf,关闭.对象即使不可见也是有效的。如果可以访问对象,就可以设置和获取其属性,并将其传递给对对象进行操作的任何函数。

HandleVisibility价值 描述
“上” 对象总是可见的。
“回调” 对象在回调或回调调用的函数中可见,但在从命令行调用的函数中不可见。此选项阻止在命令行访问对象,但允许回调函数访问它。
“关闭” 这个物体在任何时候都是看不见的。此选项对于防止另一个函数对UI的意外更改非常有用。设置HandleVisibility“关闭”在函数执行期间暂时隐藏对象。

标识符

全部展开

此属性是只读的。

图形对象的类型,返回为“uilineargauge”

对象标识符,指定为字符向量或字符串标量。您可以指定一个惟一的标签值作为对象的标识符。方法在代码中的其他地方需要访问对象时,可以使用findobj方法搜索对象标签价值。

用户数据,指定为任意MATLAB数组。例如,您可以指定标量、向量、矩阵、单元格数组、字符数组、表或结构。使用此属性可在对象上存储任意数据。

如果您在应用程序设计器中工作,请在应用程序中创建公共或私有属性以共享数据,而不是使用用户数据财产。有关更多信息,请参见在应用设计器应用中共享数据

另请参阅

功能

在R2016a中引入