主要内容

ToggleButton属性

控制切换按钮外观

切换按钮通常显示为按钮组中的一组选项。用户必须从集合中选择一个。属性控制切换按钮的外观和行为。使用点符号来引用特定的对象和属性。

无花果= uifigure;Bg = uibuttongroup(fig) tbutton = uitogglebutton(Bg);tbutton。正文= 'One';

按钮

全部展开

指定为的切换按钮的状态0(unpressed)或1(沮丧)。在给定的按钮组中,一次只能选择(按下)一个切换按钮。当价值属性设置为1,切换按钮显示为按下状态。添加到按钮组的第一个按钮的状态为1默认情况下,。添加到同一按钮组的后续按钮的默认状态为0

价值财产的ToggleButton更改1,价值属性ToggleButton更改0.此外,SelectedObject资产价值ButtonGroup是更新。

如果您以编程方式更改价值财产的ToggleButton0, MATLAB®设定价值第一属性ToggleButton添加ButtonGroup1.如果第一个ToggleButton添加的是您通过编程设置的价值财产0,然后用MATLAB设置价值财产ToggleButton添加到ButtonGroup1

请注意

第一个ToggleButton添加到一个ButtonGroup难道不是第一个吗ToggleButton上市孩子们财产的ButtonGroup

按钮标签,指定为字符向量、字符向量的单元数组、字符串标量、字符串数组或1-D分类数组。指定一个字符向量或字符串标量,以用一行文本标记按钮。使用单元格数组或字符串数组为按钮添加多行文本。数组中的每个元素表示单独的一行文本。如果将此属性指定为类别数组,MATLAB将使用数组中的值,而不是全部类别集合。

文字环绕以适应组件宽度,指定为“关闭”“上”,或数字或逻辑0假的)或1真正的).价值“关闭”相当于假的,“上”相当于真正的. 因此,可以将此属性的值用作逻辑值。该值存储为类型为的开/关逻辑值matlab.lang.OnOffSwitchState

当组件的宽度小于要显示的文本时,使用此属性可防止文本被水平剪切。

  • “关闭”-文本不会自动换行。

  • “上”-将文本分割成新行,使每一行适合组件的宽度,并尽可能避免分割单词。

设置自动换行财产“上”当组件的高度太小而无法显示所有文本行时,不会防止文本被垂直剪切。

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

金宝app支持的图像格式包括JPEG、PNG、GIF、SVG或——- - - - - -n-by-3真彩色图像数组。有关真彩色图像阵列的更多信息,请参见图像类型

  • 如果按钮文本占用位置属性值,则MATLAB不显示图标。

  • 如果有一些空间可以放置图标,那么MATLAB可以缩小图像以适应需要。

例子:“程序”指定MATLAB路径上的图标文件。

例子:'C:\Documents\icon.png'指定图像文件的完整路径。

字体和颜色

全部展开

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

如果指定的字体不可用,那么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) “# 00 ff00”

“蓝” “b” (0 0 1) #0000FF"

“青色” “c” (0 1 1) “# 00飞行符”

“红色” “米” (1 0 1) “#就”

“黄色” “是的” (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) "7E2F8E"

[0.4660 0.6740 0.1880] “# 77 ac30”

(0.3010 0.7450 0.9330) “# 4 dbeee”

(0.6350 0.0780 0.1840) "A2142F"

背景颜色,指定为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) “# 00 ff00”

“蓝” “b” (0 0 1) #0000FF"

“青色” “c” (0 1 1) “# 00飞行符”

“红色” “米” (1 0 1) “#就”

“黄色” “是的” (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) "7E2F8E"

[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

  • 如果将此属性设置为“上”,则按钮的外观表明应用程序用户可以与它进行交互。

  • 如果将此属性设置为“关闭”,则按钮的外观变暗,表示应用用户无法与该按钮进行交互。

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

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

位置

全部展开

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

元素 描述
从按钮组的左内边缘到按钮的左外边缘的距离
按钮组的内底边到按钮组的外底边的距离
宽度 按钮左右外边缘之间的距离
高度 按钮的上下外缘之间的距离

位置值是相对于可拉的区域按钮组的。可绘制区域是按钮组边框内的区域,不包括标题占据的区域。

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

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

此属性是只读的。

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

图标和文本的水平对齐,指定为“中心”“左”,或“对”.水平对齐是相对于按钮边界内的区域的。当文本跨越按钮的整个宽度时设置此属性在UI中没有明显的效果。

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

图标相对于按钮文本的位置,指定为“左”“对”“高级”,或“底”.如果正文属性为空,则图标使用水平对齐垂直对齐属性,而不是IconAlignment财产。

回调

全部展开

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

  • 函数处理。

  • 单元格数组,其中第一个元素是函数句柄。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处理队列的下一个点,例如当有刷新屏幕数字uifiguregetframe等待,或暂停命令。

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

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

  • 的值“关闭”阻止所有中断尝试。的BusyAction拥有中断回调的对象的属性确定中断回调是被丢弃还是放入队列。

请注意

在这些情况下,回调中断和执行的行为是不同的:

  • 如果中断回调为DeleteFcnCloseRequestFcnSizeChangedFcn回调,则中断发生,而不考虑打断属性值。

  • 如果正在运行的回调函数正在执行等待函数,则不管打断属性值。

  • 计时器对象根据调度执行,而不管打断属性值。

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

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

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

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

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

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

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

此属性是只读的。

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

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

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

父/子

全部展开

父容器,指定为ButtonGroup对象。的ButtonGroup一定是在数字创建使用uifigure函数。

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

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

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

标识符

全部展开

此属性是只读的。

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

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

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

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

介绍了R2016a