主要内容

ToggleButton属性

控制切换按钮外观

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

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

按钮

全部展开

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

价值A的财产ToggleButton.变化1, 这价值属性ToggleButton.变化0..此外,SelectedObject属性值ButtonGroup是更新。

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

笔记

第一个ToggleButton.添加到一个ButtonGroup不一定是第一个ToggleButton.上市孩子们财产的ButtonGroup

按钮标签,指定为字符向量,字符向量,字符串标量,字符串数组或1-D分类阵列的单元数组。指定字符向量或字符串标量,以用单行文本标记按钮。使用单元格数组或字符串数​​组来标记具有多行文本的按钮。数组中的每个元素表示单独的文本行。如果将此属性指定为分类阵列,则Matlab使用数组中的值,而不是完整的类别。

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

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

  • “关闭”- 文本不会包装。

  • '在'- 将文本分解为新行,以便每行都适合组件的宽度,并避免在可能的情况下打破单词。

设置自动换行财产'在'当组件的高度太小以显示所有文本行时,不会阻止文本垂直折衷。

图标源或文件,指定为字符向量、字符串标量或M.——- - - - - -N.-by-3真彩色图像数组。如果指定文件名,则可以是MATLAB路径上的图像文件名或图像文件的完整路径。如果您计划与其他人共享应用程序,请将MATLAB路径上的图像文件放在促进APP Packaging。

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

  • 属性指定的所有空间被按钮文本占据位置属性值,则MATLAB不显示图标。

  • 如果某些房间可用于图标,则MATLAB将缩小图像以便适合,如有必要。

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

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

字体和颜色

全部展开

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

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

例子:“天线”

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

例子:14

字体大小,指定为以下值之一:

  • '普通的'-由特定字体定义的默认权重

  • “大胆”-较厚的字符轮廓比'普通的'

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

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

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

RGB三联体和十六进制颜色代码在指定自定义颜色时很有用。

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

  • 十六进制颜色代码是以哈希符号开头的字符向量或字符串标量(),然后是3个或6个十六进制数字,其范围可以是0.F.这些值不区分大小写。因此,颜色是代码“# 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) “# 00飞行符”

样品的颜色为青色

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

彩色洋红色的样本

“黄色” “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”

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) '#77ac30'

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)

  • 十六进制颜色代码是以哈希符号开头的字符向量或字符串标量(),然后是3个或6个十六进制数字,其范围可以是0.F.这些值不区分大小写。因此,颜色是代码“# 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) “# 00飞行符”

样品的颜色为青色

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

彩色洋红色的样本

“黄色” “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”

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) '#77ac30'

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.).的值'在'相当于真正的,“关闭”相当于.因此,可以将此属性的值用作逻辑值。该值存储为开启/关闭类型的逻辑值matlab.lang.OnOffSwitchState

  • '在'—显示对象。

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

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

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

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

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

工具提示,指定为字符向量,字符向量,字符串数组或1-D分类阵列的单元格数组。使用此属性在运行时在组件上筛选指针时显示消息。即使禁用组件,工具提示也会显示。要显示多行文本,请指定字符向量或字符串数​​组的单元格数组。阵列中的每个元素都成为单独的文本行。如果将此属性指定为分类阵列,则Matlab使用数组中的值,而不是完整的类别。

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

位置

全部展开

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

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

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

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

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

此属性是只读的。

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

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

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

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

回调

全部展开

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

  • 函数处理。

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

  • 字符向量包含有效的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是当前正在执行的回调。

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

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

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

如果正在运行的回调函数确实包含这些命令之一,则可中断拥有正在运行的回调的对象的属性决定中断是否发生:

  • 如果可中断“关闭”,则不发生中断。相反,忙碌拥有中断回调的对象的属性确定中断回调是否被丢弃或添加到回调队列中。

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

笔记

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

  • 如果中断回调为DeleteFcnCloseRequestFcn,或SizeChangedFcn回调,则中断发生不管可中断属性值。

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

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

笔记

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

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

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

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

忙碌只有在满足这两种条件时,才能确定呼叫队列行为:

在这些条件下,忙碌属性决定了MATLAB如何处理中断回调。这些是可能的值忙碌属性:

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

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

此属性是只读的。

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

Matlab套装BeingDeleted财产'在'DeleteFcn回调函数开始执行。这BeingDeleted属性仍然设置为'在'直到组件对象不再存在。

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

父/子

全部展开

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

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

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

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

身份标识

全部展开

此属性是只读的。

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

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

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

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

在R2016A介绍