主要内容

按钮属性

控制按钮的外观和行为

按钮是UI组件响应当用户按下和释放他们。通过改变属性值,您可以修改按钮的外观和行为。使用点符号来引用一个特定的对象和属性。

无花果= uifigure;b = uibutton(图);b。文本=“情节”;

按钮

全部展开

按钮标签,指定为一个特征向量,单元阵列的特征向量,字符串标量字符串数组,或一维分类数组。指定一个特征向量或字符串标量标签的按钮一行文本。使用一个细胞数组或字符串数组与多行文本标签按钮。数组中的每个元素代表一个单独的行文本。如果指定这个属性作为分类数组,MATLAB®使用数组中的值,而不是完整的类别。

包装适合组件的宽度,指定为“关闭”“上”或数字或逻辑0()或1(真正的)。的值“关闭”相当于,“上”相当于真正的。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState

使用这个属性来防止文本剪水平当组件的宽度小于您想要显示的文本。

  • “关闭”——文本不包装。

  • “上”——打破文本到新行,这样适合每一行的宽度组件和避免打破如果可能的话。

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

预定义的或自定义图标,指定为一个特征向量,字符串标量,或——- - - - - -n3真彩图像数组。

预定义的图标

此表列出预定义的图标指定的值。

价值 图标
(默认) 没有图标显示。
“问题”

问题的图标

“信息”

信息图标

“成功”

成功的图标

“警告”

警告图标

“错误”

错误图标

自定义图标

指定一个自定义的图标,这些值之一:

  • 一个特征向量或字符串标量指定一个SVG的文件名,JPEG、GIF或PNG图像,在MATLAB的道路。或者,您可以指定一个图像文件的完整路径。

  • 一个——- - - - - -n3真彩图像数组。看到图像类型为更多的信息。

如果你打算与他人分享一个应用程序,将MATLAB的图像文件路径,以促进应用程序包装。

如果按钮文字占用所有指定的空间位置属性值,然后MATLAB不显示图标。如果一些房间是可用的图标,然后MATLAB尺度下图像适合,如果必要的。

字体和颜色

全部展开

字体名称,指定为一个系统支持字体名称。万博1manbetx默认字体取决于具体的操作系统和语言环境。

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

例子:“天线”

字体大小,指定为一个正数。测量的单位是像素。默认字体大小取决于具体的操作系统和语言环境。

例子: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) “# 00飞行符”

样品的颜色青色

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

样品的颜色红色

“黄色” “y” (1 1 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),它表现为深红色

背景颜色,作为一个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) “# 00飞行符”

样品的颜色青色

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

样品的颜色红色

“黄色” “y” (1 1 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),它表现为深红色

交互性

全部展开

可见性状态,指定为“上”“关闭”或数字或逻辑1(真正的)或0()。的值“上”相当于真正的,“关闭”相当于。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState

  • “上”——显示对象。

  • “关闭”——隐藏对象没有删除它。你仍然可以访问一个看不见的UI组件的属性。

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

操作状态,指定为“上”“关闭”或数字或逻辑1(真正的)或0()。的值“上”相当于真正的,“关闭”相当于。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState

  • 如果你设定这个属性“上”,应用程序用户可以与组件交互。

  • 如果你设定这个属性“关闭”,组件似乎黯淡,表明应用程序用户不能与它交互,而且它不会触发一个回调。

工具提示,指定为一个特征向量,单元阵列的特征向量,字符串数组,或一维分类数组。使用这个属性来显示一个消息当用户将鼠标悬停于指针组件在运行时。工具提示显示即使组件是禁用的。显示多行文本,指定一个单元阵列特征向量或一个字符串数组。数组中的每个元素,成为一个单独的行文本。如果指定这个属性作为分类数组,MATLAB使用数组中的值,而不是完整的类别。

指定为一个上下文菜单快捷菜单对象创建使用uicontextmenu函数。使用这个属性来显示一个上下文菜单,当你右键单击一个组件。

位置

全部展开

位置和大小的按钮,指定的向量形式(左底宽高)。此表描述向量中每个元素。

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

位置值是相对的可拉的区域父容器。在绘图区域的面积内容器的边界和不包括装饰所占据的区域如菜单栏或标题。

所有的测量都是在像素单元。

位置和大小的按钮,指定为一个四元素的向量形式(左底宽高)。所有的测量都是在像素单元。这个属性值是相同的位置财产。

这个属性是只读的。

返回的按钮,位置和大小的四元素向量形式(左底宽高)。所有的测量都是在像素单元。这个属性值是相同的位置财产。

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

垂直对齐的图标和文本,指定为“中心”,“高级”,或“底”。内部的垂直对齐是相对于区域边界的按钮。设置此属性的文本高度充满高度在UI按钮没有明显影响。

按钮图标的位置,表中指定的值。表中的示例显示指定的结果IconAlignment值的按钮HorizontalAlignment的价值“中心”

价值 描述 例子
“左” 直接显示的图标按钮左边的文本。

按钮直接与以文本和一个绿色的复选标记图标左边的文本

“对” 直接显示的图标按钮右边的文本。

按钮直接与以文本和一个绿色的复选标记图标右边的文本

“中心” 图标显示的中心按钮,在文本的后面。

与集中文本和一个绿色的复选标记图标按钮集中在文本后面

“leftmargin”

图标显示在最左边的按钮,无论文本的位置。

这个值等于“左”时的值HorizontalAlignment“左”

按钮居中文本和一个绿色的复选标记图标左边的按钮

“rightmargin”

图标显示在最右边的按钮,无论文本的位置。

这个值等于“对”时的值HorizontalAlignment“对”

按钮居中文本和一个绿色的复选标记图标在最右侧的按钮

“高级” 图标显示按钮文本的正上方。

按钮居中文本和一个绿色的复选标记图标文字的正上方

“底” 下面的图标直接显示按钮的文本。

按钮直接与以文本和一个绿色的复选标记图标下面的文本

如果文本属性的按钮是空的,则由图标的位置HorizontalAlignmentVerticalAlignment属性而不是IconAlignment财产。

布局选项,指定为一个GridLayoutOptions对象。这个属性指定组件的选项的网格布局容器。如果组件不是孩子的网格布局容器(例如,它是一个孩子的图或面板),然后这个属性是空的,没有任何影响。然而,如果组件是一个孩子的网格布局容器,您可以将组件所需的行和列的网格通过设置属性GridLayoutOptions对象。

例如,这段代码的地方一个按钮在第三行和第二列的网格。

3 g = uigridlayout ([4]);b = uibutton (g);b.Layout。行= 3;b.Layout。列= 2;

跨越多个行或列的按钮,指定房地产作为一个双元素向量。例如,这个按钮跨列2通过3:

b.Layout。列= [2 3];

回调

全部展开

按钮回调,指定这些值之一:

  • 一个处理函数。

  • 细胞数组中第一个元素是一个函数处理。后续单元阵列中的元素传递给回调函数的参数。

  • 一个特征向量包含有效的MATLAB表达式(不推荐)。MATLAB计算表达式的基本工作空间。

这个回调中,当用户单击按钮时执行应用程序。

这个回调函数可以访问特定用户的信息交互与按钮。MATLAB中传递这些信息ButtonPushedData回调函数对象作为第二个参数。在应用程序设计,论证事件。您可以查询对象的属性使用点符号。例如,event.Source返回按钮对象。的ButtonPushedData对象不可用回调函数指定为特征向量。

下表列出的属性ButtonPushedData对象。

财产 价值
EventName “ButtonPushed”
组件执行回调

写回调函数的更多信息,请参阅回调程序设计师

对象创建函数,指定这些值之一:

  • 函数处理。

  • 细胞数组中第一个元素是一个函数处理。后续单元阵列中的元素传递给回调函数的参数。

  • 特征向量包含一个有效的MATLAB表达式(不推荐)。MATLAB计算表达式的基本工作空间。

更多信息关于指定一个回调函数处理,细胞数组,或字符向量,明白了回调程序设计师

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

设置CreateFcn属性在一个现有的组件没有影响。

如果指定这个属性作为处理函数或细胞数组,您可以访问的对象被创建使用回调函数的第一个参数。否则,使用gcbo函数来访问该对象。

对象删除函数,指定这些值之一:

  • 函数处理。

  • 细胞数组中第一个元素是一个函数处理。后续单元阵列中的元素传递给回调函数的参数。

  • 特征向量包含一个有效的MATLAB表达式(不推荐)。MATLAB计算表达式的基本工作空间。

更多信息关于指定一个回调函数处理,细胞数组,或字符向量,明白了回调程序设计师

这个属性指定一个回调函数执行时MATLAB删除对象。MATLAB执行DeleteFcn回调之前破坏对象的属性。如果你不指定DeleteFcn属性,然后MATLAB默认执行删除功能。

如果指定这个属性作为处理函数或细胞数组,您可以访问的对象被删除使用回调函数的第一个参数。否则,使用gcbo函数来访问该对象。

回调执行控制

全部展开

回调中断,指定为“上”“关闭”或数字或逻辑1(真正的)或0()。的值“上”相当于真正的,“关闭”相当于。因此,您可以使用这个属性的值作为一个逻辑值。存储的值是作为一个开/关逻辑值的类型matlab.lang.OnOffSwitchState

这个属性决定了如果一个回调可以运行中断。有两种回调状态考虑:

  • 运行回调是当前执行的回调。

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

MATLAB决定调中断行为每当它执行一个命令队列处理回调。这些命令包括drawnow,,uifigure,getframe,等待,暂停

如果调不包含运行这些命令,然后没有中断发生。MATLAB首先完成执行运行回调,后来执行中断的回调。

如果跑回调也包含其中的一个命令,然后可中断对象的属性拥有运行调决定如果中断发生时:

  • 如果该值的可中断“关闭”,然后没有中断发生。相反,BusyAction对象的属性拥有打断调决定如果打断回调被丢弃或添加到队列的回调。

  • 如果该值的可中断“上”,然后中断发生。下次MATLAB处理回调队列,它停止运行的执行回调并执行中断的回调。打断调完成后,MATLAB简历执行回调。

请注意

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

  • 如果中断的回调DeleteFcn,CloseRequestFcn,或SizeChangedFcn回调,那么无论发生中断可中断属性值。

  • 如果运行目前执行的回调等待函数,那么无论发生中断可中断属性值。

  • 如果回调是由一个中断计时器对象,然后根据时间表不管回调执行可中断属性值。

请注意

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

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

  • 运行回调是当前执行的回调。

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

BusyAction属性决定了回调排队行为只有满足这两个条件:

在这种情况下,BusyAction对象的属性拥有打断调决定MATLAB如何处理中断的回调。这些都是可能的值的BusyAction属性:

  • “队列”——将中断处理回调在一个队列跑回调结束后执行。

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

这个属性是只读的。

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

MATLAB设置BeingDeleted财产“上”DeleteFcn回调函数开始执行。的BeingDeleted房地产仍将“上”直到组件对象已不复存在。

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

父/子

全部展开

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

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

这个属性控制对象的可见性在其父母的孩子。当一个对象不可见的父母的孩子,它不是由函数返回获取对象通过搜索对象层次结构或查询属性。这些功能包括得到,findobj,clf,关闭。对象是有效的,即使他们是不可见的。如果您可以访问一个对象,你可以设置它的属性,并将其传递给任何函数来操作对象。

HandleVisibility价值 描述
“上” 对象总是可见的。
“回调” 对象是可见的在回调函数或函数调用回调,但不是在从命令行调用的函数。这个选项块访问对象的命令行,但是允许回调函数来访问它。
“关闭” 对象是无形的。这个选项是有用的防止意外更改UI被另一个函数。设置HandleVisibility“关闭”暂时隐藏对象在这个函数的执行。

标识符

全部展开

这个属性是只读的。

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

对象标识符指定为一个特征向量或字符串标量。您可以指定一个唯一的标签价值作为一个对象的标识符。当你需要访问对象在您的代码,您可以使用findobj基于函数搜索对象标签价值。

用户数据,指定为任何MATLAB数组。例如,您可以指定一个标量、向量,矩阵,单元阵列,字符数组,表,或者结构。使用这个属性来存储任意数据对象。

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

版本历史

介绍了R2016a

全部展开

另请参阅

功能