主要内容

StateButton属性

控制状态按钮外观和行为

状态按钮是指示逻辑状态的组件。属性控制状态按钮的外观和行为。使用点符号引用特定的对象和属性。

无花果= uifigure;某人= uibutton(无花果、“国家”);sb.Value = true;

按钮

展开全部

按下按钮,指定为0(假)或1(真的)。当值为1时,显示状态按钮显示。当值为0时,状态按钮会出现未置换。

按钮标签,指定为字符向量、字符向量的单元数组、字符串标量、字符串数组或一维分类数组。指定一个字符向量或字符串标量,用一行文本标记按钮。使用单元格数组或字符串数组为按钮添加多行文本。数组中的每个元素代表一个单独的文本行。如果你指定这个属性为类别数组,MATLAB®使用数组中的值,而不是完整的类别集。

自动换行以适应组件宽度,指定为'离开'“上”,或作为数字或逻辑0)或1真正的).的值'离开'相当于,“上”相当于真正的.因此,您可以将此属性的值用作逻辑值。该值存储为开/关类型的逻辑值matlab.lang.OnoffSwitchState.

使用此属性以防止在组件的宽度小于要显示的文本时水平剪裁。

  • '离开'-文本不换行。

  • “上”-将文本拆分为新行,以便每行符合组件的宽度,并尽可能避免拆分单词。

设置WordWrap.财产“上”当组件的高度太小而不能显示所有文本行时,不会阻止文本垂直裁剪。

图标源或文件,指定为字符向量,字符串标量或者-经过-n- * 3真彩色图像数组。如果您指定了一个文件名,它可以是MATLAB路径上的图像文件名,也可以是图像文件的完整路径。如果您计划与他人共享一个应用程序,请将图像文件放在MATLAB路径上,以便于应用程序的打包。

万博1manbetx支持的图像格式包括JPEG, PNG, GIF, SVG或-经过-n- * 3真彩色图像数组。有关TrueColor图像阵列的更多信息,请参阅图像类型

  • 控件指定的所有空间位置属性值,然后matlab不显示图标。

  • 如果图标有一些可用的空间,那么MATLAB将缩小图像以适应,如果必要的话。

例子:'icon.png'指定MATLAB路径上的图标文件。

例子:“C: \ \程序文件”指定图像文件的完整路径。

字体和颜色

展开全部

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

如果指定的字体不可用,则Matlab使用应用程序正在运行的系统上可用的字体之间的最佳匹配。

例子:'arial'

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

例子:14

字体重量,指定为其中一个值:

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

  • “大胆”- 比较厚的字符概述“正常”

不是所有字体都有粗体字体粗体。因此,指定粗体字体粗细可以得到正常的字体粗细。

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

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

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

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

  • 十六进制颜色代码是字符向量或以哈希符号开头的字符串标量()接着是三个或六个十六进制数字,可以从0F.这些值不区分大小写。因此,颜色编码“# FF8800”“# ff8800”“# F80”,“# f80”是等价的。

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

颜色名称 简称 RGB值 十六进制颜色代码 外观
“红色” “r” (1 0 0) “# FF0000”

“绿色” 'G' [0 1 0] “# 00 ff00”

'蓝色的' “b” [0 0 1] “# 0000 ff”

“青色” “c” [0 1 1] '#00ffff'

'品红' 'M' (1 0 1) '#ff00ff'

'黄色的' “y” (1 1 0) “# FFFF00”

“黑” 'K' [0 0 0] '#000000'

“白色” ' w ' (1 1 1) “# FFFFFF”

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

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] “# 7 e2f8e”

(0.4660 0.6740 0.1880) '#77ac30'

[0.3010 0.7450 0.9330] '#4dbeee'

(0.6350 0.0780 0.1840) “# A2142F”

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

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

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

  • 十六进制颜色代码是字符向量或以哈希符号开头的字符串标量()接着是三个或六个十六进制数字,可以从0F.这些值不区分大小写。因此,颜色编码“# FF8800”“# ff8800”“# F80”,“# f80”是等价的。

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

颜色名称 简称 RGB值 十六进制颜色代码 外观
“红色” “r” (1 0 0) “# FF0000”

“绿色” 'G' [0 1 0] “# 00 ff00”

'蓝色的' “b” [0 0 1] “# 0000 ff”

“青色” “c” [0 1 1] '#00ffff'

'品红' 'M' (1 0 1) '#ff00ff'

'黄色的' “y” (1 1 0) “# FFFF00”

“黑” 'K' [0 0 0] '#000000'

“白色” ' w ' (1 1 1) “# FFFFFF”

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

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] “# 7 e2f8e”

(0.4660 0.6740 0.1880) '#77ac30'

[0.3010 0.7450 0.9330] '#4dbeee'

(0.6350 0.0780 0.1840) “# A2142F”

交互性

展开全部

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

  • “上”—显示对象。

  • '离开'—隐藏对象,但不删除对象。您仍然可以访问不可见UI组件的属性。

为了让你的应用程序启动得更快,设置可见的财产'离开'对于所有不需要在启动时出现的UI组件。

操作状态,指定为“上”'离开',或作为数字或逻辑1真正的)或0).的值“上”相当于真正的,'离开'相当于.因此,您可以将此属性的值用作逻辑值。该值存储为开/关类型的逻辑值matlab.lang.OnoffSwitchState.

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

  • 如果将此属性设置为'离开',组件显示为灰色,表示应用程序用户无法与它交互,也不会触发回调。

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

上下文菜单,指定为上下文菜单使用的对象UIContextMenu.功能。右键单击组件时,请使用此属性显示上下文菜单。

位置

展开全部

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

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

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

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

按钮的位置和大小,指定为表单的四元素向量[左下宽度].所有测量都以像素为单位。此属性值与此属性相同位置财产。

此属性是只读的。

按钮的位置和大小,作为表单的四个元素向量返回[左下宽度].所有测量都以像素为单位。此属性值与此属性相同位置财产。

图标和文本的水平对齐方式,指定为'中央'“左”,或'正确的'.水平对齐相对于按钮边框内的区域。当文本跨越按钮的全宽度时,设置此属性在UI中没有明显的效果。

图标和文本的垂直对齐方式,指定为'中央'“高级”,或“底”.垂直对齐相对于按钮边框内的区域。当文本高度填充按钮高度时设置此属性在UI中没有明显效果。

相对于按钮文本的图标位置,指定为“左”'正确的'“高级”,或“底”.如果文本属性是空的,那么图标使用HorizontalAlignmentVerticalAlignment属性,而不是IconAlignment财产。

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

例如,这段代码将一个状态按钮放在其父网格的第三行和第二列中。

g = uigrivlayout([4 3]);SB = UIBUTTON(G,“状态”);sb.layout.row = 3;sb.layout.column = 2;

要使按钮跨越多行或列,请指定柱子属性作为双元素矢量。例如,此按钮跨栏2通过3.

sb.Layout.Column = [2 3];

回调

展开全部

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

  • 一个处理函数。

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

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

当用户在应用程序中更改按钮状态时执行此回调。如果状态以编程方式更改,则不会执行它。

这个回调函数可以访问关于用户与按钮交互的特定信息。MATLAB通过一个valuechangeddata.对象作为回调函数的第二个参数。在App Designer中,调用该参数事件.您可以使用点表示法查询对象属性。例如,Event.PreviousValue.返回按钮的前一个值。的valuechangeddata.对象对指定为字符向量的回调函数不可用。

属性的属性如下表所示valuechangeddata.对象。

财产 价值
价值 在应用程序用户最近一次与它交互后的状态按钮的值
inverionvalue. 状态按钮的价值在App用户最近与它交互之前
来源 执行回调的组件
EventName 'valuechanged'

有关编写回调的更多信息,请参见在App Designer中编写回调

对象创建函数,指定为其中一个值:

  • 函数处理。

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

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

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见在App Designer中编写回调

这个属性指定了当MATLAB创建对象时要执行的回调函数。MATLAB初始化所有属性值之前,执行CreateFcn.打回来。如果不指定CreateFcn.属性,然后matlab执行默认的创建功能。

设置CreateFcn.属性对现有组件不起作用。

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

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

  • 函数处理。

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

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

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见在App Designer中编写回调

这个属性指定了当MATLAB删除对象时要执行的回调函数。MATLAB执行deletefcn.在销毁对象的属性之前回调。如果不指定deletefcn.属性,然后matlab执行默认删除函数。

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

回调执行控制

展开全部

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

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

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

  • 中断回调是一个回调,它试图中断运行的回调。

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

  • 的值“上”允许其他回调中断对象的回调。中断发生在matlab处理队列的下一个点,例如何时存在drawnow数字uifiguregetframe等待,或暂停命令。

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

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

  • 的值'离开'阻止所有中断尝试。的BusyAction属性确定中断回调是被丢弃还是放入队列。

请注意

回调中断和执行在以下情况下的行为不同:

  • 如果中断回叫是deletefcn.CloseEquestfcn.SizeChangedFcn回调,则中断将发生,而不管可中断属性值。

  • 如果正在运行的回调当前正在执行等待功能,无论的内容都会发生中断可中断属性值。

  • 计时器无论如何,对象根据计划执行可中断属性值。

当中断发生时,MATLAB不保存属性或显示状态。对象返回的对象GCA.GCF.当另一个回调执行时,命令可能会改变。

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

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

  • 中断回调是一个回调,它试图中断运行的回调。

每当MATLAB调用一个回调函数时,该回调函数试图中断一个正在运行的回调函数。的可中断拥有运行回调的对象的属性确定是否允许中断。如果不允许中断,那么BusyAction拥有中断回调的对象的属性确定它是被丢弃还是放入队列。这些是可能的值BusyAction属性:

  • '队列'—在正在运行的回调执行完毕后,将中断的回调放入一个队列中等待处理。

  • '取消'—不执行中断回呼。

此属性是只读的。

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

MATLAB设置呈扭曲财产“上”当。。。的时候deletefcn.回调开始执行。的呈扭曲属性仍设置为“上”直到组件对象不再存在。

检查的值呈扭曲属性来验证在查询或修改对象之前不打算删除该对象。

父/子

展开全部

指定为数字使用的对象uifigure功能,或其中一个子容器:标签面板buttongroup.,或GridLayout.如果没有指定容器,MATLAB调用uifigure函数创建一个新的数字作为父容器的对象。

对象句柄的可见性,指定为“上”“回调”,或'离开'

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

Hupplvisibility价值 描述
“上” 对象总是可见的。
“回调” 该对象在回调函数或由回调函数调用的函数中可见,但在从命令行调用的函数中不可见。这个选项阻止在命令行访问该对象,但允许回调函数访问它。
'离开' 这个物体一直是看不见的。此选项用于防止另一个函数对UI进行意外更改。设置HandleVisibility'离开'在该函数执行期间暂时隐藏该对象。

标识符

展开全部

此属性是只读的。

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

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

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

如果你在App Designer中工作,在App中创建公共或私有属性来共享数据,而不是使用用户数据财产。有关更多信息,请参阅在App Designer应用程序中共享数据

另请参阅

功能

介绍了R2016a