主要内容

旋钮特性

控制旋钮的外观和行为

旋钮是代表仪表控制旋钮的UI组件,用户可以调整旋钮以控制值。属性控制旋钮的外观和行为。使用点符号表示特定对象和属性:

无花果= uifigure;k = uiknob(图);k.Value = 45;

旋钮

全部展开

旋钮的值,指定为数字。数字必须在为指定的范围内限制

最小和最大旋钮值,指定为两个元素的数字数组。数组中的第一个值必须小于第二个值。

如果你改变限制这样价值属性小于新的下限,则价值属性更新为新的下限。同样,如果你改变限制这样价值大于新的上限,则价值属性更新为新的上限。

例如,假设限制[0 100]价值属性是20.如果限制属性改变[50 100],然后价值更新50

滴答声

全部展开

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

勾选超出范围的位置限制属性不显示。

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

设定少校属性设置MajorTicksMode财产“手册”

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

  • “自动”-MATLAB确定主刻度的位置。

  • “手册”-您可以指定少校值数组。

主要标记标签,指定为字符向量、字符串数组或1-D分类数组的单元格数组。如果不想显示标记标签,请将此属性指定为空单元格数组。属性中的对应元素指定空字符向量或空字符串标量MajorTickLabels所有物如果将此属性指定为分类数组,则MATLAB将使用数组中的值,而不是整个类别集。

如果MajorTickLabels数组的长度不同于少校向量,MATLAB忽略较长数组的额外项。如果有额外的标签,它们将被忽略。如果有额外的勾号,则不显示标签。

设置MajorTickLabels改变了MajorTickLabelsMode重视“手册”

主刻度标签模式,指定为以下选项之一:

  • “自动”-MATLAB指定主要刻度标签。

  • “手册”-可以使用MajorTickLabels所有物

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

勾选超出范围的位置限制属性不显示。

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

设定MinorTicks属性值设置MinorTicksMode属性值对“手册”

Minor tick创建模式,指定为以下方式之一:

  • “自动”-MATLAB确定次要记号的位置。MATLAB不会为超出比例限制的主要记号生成次要记号。如果限制属性值的变化,然后MATLAB更新小标记来填充完整的刻度范围(MinorTicks属性将相应地更新)。

  • “手册”-您可以指定MinorTicks属性数值数组。这个MinorTicks属性值本身不会更改大小或内容。

字体

全部展开

字体名称,指定为系统支持的字体名称。默认字体取决于特定的操作系统和万博1manbetx区域设置。

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

例子:“天线”

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

例子:14

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

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

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

并不是所有的字体都有粗体字体。因此,指定粗体字体权重可能导致正常字体权重。

字体角度,指定为“正常”“斜体”。将此属性设置为斜体选择字体的倾斜版本(如果在应用程序用户的系统上可用)。

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

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

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

  • 十六进制颜色代码是以哈希符号开头的字符向量或字符串标量(#),然后是3个或6个十六进制数字,其范围可以是0F。值不区分大小写。因此,颜色代码“#FF8800”,“# ff8800”,“#F80”“#f80”是等价的。

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

颜色名称 短名称 RGB三重态 十六进制颜色代码 外貌
“红色” “r” [1 0 0] “#FF0000”

“绿色” “g” [0 1 0] “#00FF00”

“蓝” “b” (0 0 1) “# 0000 ff”

“青色” “c” [0 1 1] “#00FFFF”

“红色” “米” [1 0 1] “#FF00FF”

“黄色” “y” [1 1 0] “# FFFF00”

“黑色” “k” (0 0 0) # 000000的

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

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

RGB三重态 十六进制颜色代码 外貌
[0 0.4470 0.7410] “# 0072 bd”

(0.8500 0.3250 0.0980) "D95319"

(0.9290 0.6940 0.1250) "EDB120"

(0.4940 0.1840 0.5560) “# 7 e2f8e”

(0.4660 0.6740 0.1880) “# 77 ac30”

(0.3010 0.7450 0.9330) “# 4 dbeee”

[0.6350 0.0780 0.1840] “# A2142F”

互动性

全部展开

可见性状态,指定为“上”“关闭”,或作为数字或逻辑1.(符合事实的)或0().的值“上”相当于符合事实的“关闭”相当于.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnOffSwitchState

  • “上”-显示对象。

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

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

操作状态,指定为“上”“关闭”,或作为数字或逻辑1.(符合事实的)或0().的值“上”相当于符合事实的“关闭”相当于.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnOffSwitchState

  • 如果将此属性设置为“上”,应用程序用户可以与组件交互。

  • 如果将此属性设置为“关闭”,组件显示为灰色,表示应用程序用户无法与其交互,并且不会触发回调。

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

上下文菜单,指定为上下文菜单使用uicontextmenu作用使用此属性在组件上单击鼠标右键时显示关联菜单。

位置

全部展开

旋钮的位置和尺寸,不包括记号和标签,指定为矢量,[左下宽高].此表描述了向量中的每个元素。

要素 描述
左边 从父容器左内边缘到旋钮左外边缘的距离
从母容器内底边到旋钮外底边的距离
宽度 旋钮左右外边缘之间的距离,不包括记号和标签
身高 旋钮顶部和底部外边缘之间的距离,不包括记号和标签

所有测量值均以像素为单位。由于纵横比限制,您不能单独更改旋钮的高度和宽度。若要增加旋钮的大小,请使用设置宽度和高度位置(3:4)=[宽度高度]

这个位置值是相对于可抽面积父容器的。绘制区域是容器边界内的区域,不包括菜单栏或标题等装饰占据的区域。

例子:[100 200 60 60

旋钮的内部位置和尺寸,不包括记号和记号标签,指定为矢量,[左下宽高]. 位置值相对于父容器。所有测量值均以像素为单位。此属性值与位置所有物

此属性是只读的。

旋钮的外部位置和尺寸,包括记号标记和记号标签,指定为矢量,[左下宽高].位置值相对于父容器。所有的测量都以像素为单位。

作为指定的布局选项GridLayoutOptions对象。此属性为网格布局容器的子组件指定选项。如果该组件不是网格布局容器的子组件(例如,它是图形或面板的子组件),则此属性为空且无效。但是,如果组件是网格布局容器的子级,则可以通过设置一行上的属性GridLayoutOptions对象

例如,这段代码在其父网格的第三行和第二列放置了一个旋钮。

g=uigridlayout([4 3]);k=uiknob(g);k.Layout.Row=3;k.Layout.Column=2;

要使旋钮跨越多行或多列,请指定一行属性为二元素向量。例如,这个旋钮跨列2.通过3.:

k.Layout.Column = [2 3];

回调

全部展开

Value changed callback,指定为以下值之一:

  • 函数句柄。

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

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

当用户将旋钮选择器更改为指向不同的值时,执行此回调。

此回调函数可以访问有关用户与旋钮交互的特定信息。MATLAB以一种简单的方式传递此信息值更改数据对象作为回调函数的第二个参数。在应用程序设计器中,调用该参数事件。您可以使用点表示法查询对象属性。例如,事件。PreviousValue返回旋钮的前一个值。这个值更改数据对象不可用于指定为字符向量的回调函数。

下表列出了值更改数据对象

财产 价值
价值 应用程序用户最近一次与旋钮交互后的值。
PreviousValue 应用程序用户最近与其交互之前的旋钮值。
执行回调的组件。
事件名 “价值改变”

有关编写回调的更多信息,请参阅在应用程序设计器中编写回调

值改变回调,指定为以下值之一:

  • 函数句柄。

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

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

当用户转动应用程序中的旋钮时,将执行此回调。如果价值通过编程方式属性更改。

此回调函数可以访问有关用户与旋钮交互的特定信息。MATLAB以一种简单的方式传递此信息价值变化数据对象作为回调函数的第二个参数。在应用程序设计器中,调用该参数事件。您可以使用点表示法查询对象属性。例如,事件值返回旋钮的当前值。这个价值变化数据对象不可用于指定为字符向量的回调函数。

下表列出了价值变化数据对象

财产 价值
价值 应用程序用户与旋钮交互时旋钮的当前值。
执行回调的组件。
事件名 “价值改变”

这个价值财产的旋钮对象在应用程序用户释放旋钮之前不会更新。因此,要在旋转旋钮时获取旋钮值,您的代码必须获取价值财产的价值变化数据对象

回调函数执行如下:

  • 如果应用程序用户单击旋钮值,则回调执行一次。例如,如果旋钮为1.0,而应用程序用户单击1.1,则回调执行。

  • 如果应用程序用户单击并将旋钮拖动到新位置,回调将重复执行。例如,如果旋钮值为1.0,并且应用程序用户单击、按住并拖动到值10.0,则回调将执行多次,直到应用程序用户释放旋钮。

有关编写回调的更多信息,请参阅在应用程序设计器中编写回调

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

  • 函数处理。

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

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

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

此属性指定MATLAB创建对象时要执行的回调函数。MATLAB在执行CreateFcn回调。如果不指定CreateFcn属性,然后MATLAB执行一个默认创建函数。

设定CreateFcn现有组件上的属性无效。

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

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

  • 函数处理。

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

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

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

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

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

回调执行控制

全部展开

回调中断,指定为“上”“关闭”,或作为数字或逻辑1.(符合事实的)或0().的值“上”相当于符合事实的“关闭”相当于.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnOffSwitchState

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

  • 这个跑步callback是当前正在执行的回调。

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

每当MATLAB调用回调时,该回调尝试中断正在运行的回调(如果存在的话)。这个可中断属性决定是否允许中断。

  • 的值“上”允许其他回调中断对象的回调。中断发生在MATLAB处理队列的下一个点上,例如当存在drawnow,图形,uifigure,getframe,等待暂停命令

    • 如果正在运行的回调包含这些命令中的一个,那么MATLAB将在该点停止回调的执行,并执行中断回调。当中断回调完成时,MATLAB恢复执行正在运行的回调。

    • 如果正在运行的回调不包含这些命令中的任何一个,那么MATLAB将在不中断的情况下完成回调的执行。

  • 的值“关闭”阻止所有中断尝试。这个巴士行动拥有中断回调的对象的属性决定中断回调是否被丢弃或放入队列中。

笔记

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

  • 如果中断回调是DeleteFcn,关闭请求FCNSizeChangedFcn回调,则中断发生不管可中断属性值。

  • 如果正在运行的回调当前正在执行等待函数,则无论可中断属性值。

  • 计时器对象根据计划执行,而不考虑可中断属性值。

发生中断时,MATLAB不会保存属性或显示的状态。例如,由gcagcf命令可能在执行另一个回调时更改。

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

  • 这个跑步callback是当前正在执行的回调。

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

当MATLAB调用回调时,回调试图中断正在运行的回调。这个可中断属性决定是否允许中断。如果不允许中断,那么巴士行动拥有中断回调的对象的属性决定了它是被丢弃还是放入队列中。这些是可能的值巴士行动财产:

  • “队列”-在正在运行的回调完成执行后,将中断回调放入要处理的队列中。

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

此属性是只读的。

删除状态,返回类型为开/关逻辑值matlab.lang.OnOffSwitchState

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

检查被删除属性,以验证在查询或修改对象之前不会删除该对象。

父母/子女

全部展开

父容器,指定为图形使用uifigure函数或其子容器之一:选项卡,面板,ButtonGroupGridLayout.如果没有指定容器,则MATLAB调用uifigure函数创建一个新的图形对象,该对象用作父容器。

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

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

可处理性值 描述
“上” 对象始终可见。
“回调” 该对象在回调或回调调用的函数中可见,但在从命令行调用的函数中不可见。此选项阻止在命令行访问对象,但允许回调函数访问它。
“关闭” 该对象始终不可见。此选项有助于防止其他函数对UI进行意外更改。设定可操作性“关闭”在函数执行期间暂时隐藏对象。

标识符

全部展开

此属性是只读的。

图形对象的类型,返回为“Ui旋钮”

对象标识符,指定为字符向量或字符串标量。你可以指定一个唯一的标签值作为对象的标识符。当您需要访问代码中其他地方的对象时,可以使用芬多布吉函数搜索对象标签价值

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

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

R2016a中引入