按钮属性
控制按钮的外观和行为
按钮是用户按下和释放按钮时作出响应的UI组件。通过更改属性值,可以修改按钮的外观和行为。使用点表示法来引用特定的对象和属性。
FIG = ufigure;B = uibutton(图);b.Text = 'Plot';
按钮
文本
- - - - - -按钮标签
“按钮”
(默认)|特征向量|字符向量的单元格数组|字符串标量|字符串数组|……
按钮标签,指定为字符向量、字符向量的单元格数组、字符串标量、字符串数组或1-D分类数组。指定一个字符向量或字符串标量,用一行文本标记按钮。使用单元格数组或字符串数组用多行文本标记按钮。数组中的每个元素代表一个单独的文本行。如果将此属性指定为分类数组,MATLAB®使用数组中的值,而不是全部类别集。
自动换行
- - - - - -换行以适应组件宽度
“关闭”
(默认)|开/关逻辑值
换行以适合组件宽度,指定为“关闭”
或“上”
,或作为数字或逻辑0
(假
)或1
(真正的
).值为“关闭”
等于假
,“上”
等于真正的
.因此,您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState
.
使用此属性可防止在组件宽度小于要显示的文本时水平剪切文本。
“关闭”
—文本不自动换行。“上”
-将文本分解成新的行,以便每一行都适合组件的宽度,并尽可能避免断句。
设置自动换行
财产“上”
当组件的高度太小而无法显示所有文本行时,不阻止垂直剪切文本。
图标
- - - - - -图标源或文件
”
(默认)|特征向量|字符串标量|米
——- - - - - -n
-by-3真彩色图像数组
图标源或文件,指定为字符向量、字符串标量或米
——- - - - - -n
-by-3真彩色图像数组。如果指定了文件名,它可以是MATLAB路径上的图像文件名,也可以是图像文件的完整路径。如果您计划与他人共享某个应用程序,请将图像文件放在MATLAB路径下,以便打包应用程序。
金宝app支持的图像格式包括JPEG、PNG、GIF、SVG或米
——- - - - - -n
-by-3真彩色图像数组。有关真彩色图像数组的更多信息,请参见图像类型.
属性所指定的所有空间
位置
属性值,则MATLAB不显示该图标。如果图标有一些可用的空间,MATLAB就会根据需要缩小图像。
例子:“程序”
指定MATLAB路径下的图标文件。
例子:“C: \ \程序文件”
指定映像文件的完整路径。
字体和颜色
字体名
- - - - - -字体的名字
系统支持的字体金宝app名称
字体名称,指定为系统支持的字体名称。金宝app默认字体取决于特定的操作系统和区域设置。
如果指定的字体不可用,MATLAB将使用运行应用程序的系统上可用的字体中的最佳匹配。
例子:“天线”
字形大小
- - - - - -字体大小
正数
字体大小,指定为正数。测量单位是像素。默认字体大小取决于特定的操作系统和区域设置。
例子:14
FontWeight
- - - - - -字体粗细
“正常”
(默认)|“大胆”
字体权重,指定为以下值之一:
“正常”
-由特定字体定义的默认重量“大胆”
-较粗的字符轮廓“正常”
并非所有字体都有粗体字体粗体。对于没有的字体,指定“大胆”
结果显示正常字体粗细。
FontAngle
- - - - - -字体角
“正常”
(默认)|“斜体”
字体角度,指定为“正常”
或“斜体”
.不是所有字体都有斜体角度。对于没有的字体,指定“斜体”
结果字体角度正常。
FontColor
- - - - - -字体颜色
[0 0 0]
(默认)|RGB值|十六进制颜色代码|“r”
|‘g’
|“b”
|……
字体颜色,指定为RGB三元组、十六进制颜色代码或表中列出的选项之一。
RGB三组和十六进制颜色代码对于指定自定义颜色很有用。
RGB三元组是一个三元素行向量,其元素指定颜色的红、绿和蓝分量的强度。强度必须在这个范围内
[0, 1]
;例如,[0.4 0.6 0.7]
.十六进制颜色码是字符向量或以散列符号(
#
)后面跟着三个或六个十六进制数字,取值范围为0
来F
.这些值不区分大小写。因此,颜色代码“# FF8800”
,“# ff8800”
,“# F80”
,“# f80”
是等价的。
或者,您可以通过名称指定一些常用颜色。该表列出了已命名的颜色选项、等效的RGB三元组和十六进制颜色代码。
颜色名称 | 短名称 | RGB值 | 十六进制颜色代码 | 外观 |
---|---|---|---|---|
“红色” |
“r” |
[10 0 0] |
“# FF0000” |
|
“绿色” |
‘g’ |
[0 10 0] |
“# 00 ff00” |
|
“蓝” |
“b” |
[0 0 1] |
“# 0000 ff” |
|
“青色” |
“c” |
[0 1 1] |
“# 00飞行符” |
|
“红色” |
“米” |
[10 0 1] |
“#就” |
|
“黄色” |
“y” |
[11 10 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” |
|
写成BackgroundColor
- - - - - -背景颜色
[0.96 0.96 0.96]
(默认)|RGB值|十六进制颜色代码|“r”
|‘g’
|“b”
|……
背景色,指定为RGB三元组、十六进制颜色代码或表中列出的颜色选项之一。
RGB三组和十六进制颜色代码对于指定自定义颜色很有用。
RGB三元组是一个三元素行向量,其元素指定颜色的红、绿和蓝分量的强度。强度必须在这个范围内
[0, 1]
;例如,[0.4 0.6 0.7]
.十六进制颜色码是字符向量或以散列符号(
#
)后面跟着三个或六个十六进制数字,取值范围为0
来F
.这些值不区分大小写。因此,颜色代码“# FF8800”
,“# ff8800”
,“# F80”
,“# f80”
是等价的。
或者,您可以通过名称指定一些常用颜色。该表列出了已命名的颜色选项、等效的RGB三元组和十六进制颜色代码。
颜色名称 | 短名称 | RGB值 | 十六进制颜色代码 | 外观 |
---|---|---|---|---|
“红色” |
“r” |
[10 0 0] |
“# FF0000” |
|
“绿色” |
‘g’ |
[0 10 0] |
“# 00 ff00” |
|
“蓝” |
“b” |
[0 0 1] |
“# 0000 ff” |
|
“青色” |
“c” |
[0 1 1] |
“# 00飞行符” |
|
“红色” |
“米” |
[10 0 1] |
“#就” |
|
“黄色” |
“y” |
[11 10 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
(假
).值为“上”
等于真正的
,“关闭”
等于假
.因此,您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState
.
“上”
—显示对象。“关闭”
—隐藏对象,但不删除对象。您仍然可以访问不可见UI组件的属性。
要使应用程序启动更快,请设置可见
财产“关闭”
用于所有不需要在启动时出现的UI组件。
启用
- - - - - -操作状态
“上”
(默认)|开/关逻辑值
操作状态,指定为“上”
或“关闭”
,或作为数字或逻辑1
(真正的
)或0
(假
).值为“上”
等于真正的
,“关闭”
等于假
.因此,您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState
.
如果将此属性设置为
“上”
,应用程序用户可以与组件交互。如果将此属性设置为
“关闭”
,该组件显示为暗,表明应用程序用户无法与它交互,并且它不会触发回调。
工具提示
- - - - - -工具提示
”
(默认)|特征向量|字符向量的单元格数组|字符串数组|一维分类数组
工具提示,指定为字符向量、字符向量的单元格数组、字符串数组或1-D分类数组。使用此属性可在用户在运行时将指针悬停在组件上时显示一条消息。即使禁用了组件,也会显示工具提示。若要显示多行文本,请指定字符向量的单元格数组或字符串数组。数组中的每个元素都成为一个单独的文本行。如果将此属性指定为分类数组,MATLAB将使用数组中的值,而不是全部类别集。
快捷菜单
- - - - - -上下文菜单
空GraphicsPlaceholder
数组(默认)|快捷菜单
对象
上下文菜单,指定为快捷菜单
对象创建。uicontextmenu
函数。使用此属性可在右键单击组件时显示上下文菜单。
位置
位置
- - - - - -按钮的位置和大小
[100 100 100 22]
(默认)|[左下宽高]
按钮的位置和大小,指定为窗体的向量[左下宽高]
.该表描述了向量中的每个元素。
元素 | 描述 |
---|---|
左 |
从父容器的左内边缘到按钮的左外边缘的距离 |
底 |
从父容器的内底边到按钮的外底边的距离 |
宽度 |
按钮左右外缘之间的距离 |
高度 |
按钮的顶部和底部外边缘之间的距离 |
的位置
值相对于可拉的区域父容器的。可绘制区域是容器边界内的区域,不包括菜单栏或标题等装饰所占用的区域。
所有的测量都以像素为单位。
InnerPosition
- - - - - -按钮的位置和大小
[100 100 100 22]
(默认)|[左下宽高]
按钮的位置和大小,指定为窗体的四个元素向量[左下宽高]
.所有的测量都以像素为单位。属性值与位置
财产。
OuterPosition
- - - - - -按钮的位置和大小
[100 100 100 22]]
(默认)|[左下宽高]
此属性是只读的。
按钮的位置和大小,作为窗体的四个元素向量返回[左下宽高]
.所有的测量都以像素为单位。属性值与位置
财产。
HorizontalAlignment
- - - - - -图标和文本的水平对齐
“中心”
(默认)|“左”
|“对”
图标和文本的水平对齐,指定为“中心”
,“左”
,或“对”
.水平对齐相对于按钮边框内的区域。当文本跨越按钮的整个宽度时设置此属性在UI中没有明显的效果。
VerticalAlignment
- - - - - -图标和文本的垂直对齐
“中心”
(默认)|“高级”
|“底”
图标和文本的垂直对齐方式,指定为“中心”
,“高级”
,或“底”
.垂直对齐相对于按钮边框内的区域。当文本高度填充按钮高度时设置此属性在UI中没有明显效果。
IconAlignment
- - - - - -图标相对于按钮文本的位置
“左”
(默认)|“对”
|“中心”
|“高级”
|“底”
图标相对于按钮文本的位置,指定为“左”
,“对”
,“中心”
,“高级”
,或“底”
.如果文本
属性为空,则图标使用HorizontalAlignment
而且VerticalAlignment
属性,而不是IconAlignment
财产。
布局
- - - - - -布局选项
空LayoutOptions
数组(默认)|GridLayoutOptions
对象
布局选项,指定为GridLayoutOptions
对象。此属性指定网格布局容器的子组件的选项。如果组件不是网格布局容器的子组件(例如,它是图形或面板的子组件),则此属性为空,没有作用。但是,如果组件是网格布局容器的子元素,则可以将组件放置在网格的所需行和列中行
而且列
属性GridLayoutOptions
对象。
例如,这段代码将按钮放置在其父网格的第三行和第二列中。
G = uigridlayout([4 3]);B = uibutton(g);b.Layout.Row = 3;b.Layout.Column = 2;
要使按钮跨多行或多列,请指定行
或列
属性作为两元素向量。例如,此按钮跨列2
通过3.
:
b.Layout.Column = [2 3];
回调
ButtonPushedFcn
- - - - - -按下回调按钮
”
(默认)|函数处理|单元阵列|特征向量
按下的回调按钮,指定为以下值之一:
一个函数句柄。
第一个元素为函数句柄的单元格数组。单元格数组中的后续元素是传递给回调函数的参数。
包含有效MATLAB表达式的字符向量(不推荐)。MATLAB在基本工作空间中计算这个表达式。
当用户在应用程序中单击按钮时执行这个回调。
这个回调函数可以访问关于用户与按钮交互的特定信息。MATLAB将此信息传递到ButtonPushedData
对象作为回调函数的第二个参数。在App Designer中,这个参数被调用事件
.您可以使用点表示法查询对象的属性。例如,事件。源
返回按钮
对象。的ButtonPushedData
对象对于指定为字符向量的回调函数不可用。
属性的属性如下表所示ButtonPushedData
对象。
财产 | 价值 |
---|---|
EventName |
“ButtonPushed” |
源 |
组件执行回调 |
有关编写回调函数的详细信息,请参见应用程序设计器中的回调.
CreateFcn
- - - - - -创建函数
”
(默认)|函数处理|单元阵列|特征向量
对象创建函数,指定为以下值之一:
函数处理。
单元格数组,其中第一个元素是函数句柄。单元格数组中的后续元素是传递给回调函数的参数。
包含有效MATLAB表达式的字符向量(不推荐)。MATLAB在基本工作空间中计算这个表达式。
有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见应用程序设计器中的回调.
此属性指定在MATLAB创建对象时执行的回调函数。函数执行之前,MATLAB初始化所有属性值CreateFcn
回调。如果没有指定CreateFcn
属性,然后MATLAB执行默认的创建函数。
设置CreateFcn
属性在现有组件上不起作用。
如果将此属性指定为函数句柄或单元格数组,则可以使用回调函数的第一个参数访问正在创建的对象。否则,使用gcbo
函数来访问对象。
DeleteFcn
- - - - - -删除函数
”
(默认)|函数处理|单元阵列|特征向量
对象删除函数,指定为以下值之一:
函数处理。
单元格数组,其中第一个元素是函数句柄。单元格数组中的后续元素是传递给回调函数的参数。
包含有效MATLAB表达式的字符向量(不推荐)。MATLAB在基本工作空间中计算这个表达式。
有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见应用程序设计器中的回调.
此属性指定在MATLAB删除对象时执行的回调函数。MATLAB执行DeleteFcn
在销毁对象的属性之前。如果没有指定DeleteFcn
属性,然后MATLAB执行默认删除函数。
如果将此属性指定为函数句柄或单元格数组,则可以使用回调函数的第一个参数访问正在删除的对象。否则,使用gcbo
函数来访问对象。
回调执行控制
可中断
- - - - - -回调中断
“上”
(默认)|开/关逻辑值
回调中断,指定为“上”
或“关闭”
,或作为数字或逻辑1
(真正的
)或0
(假
).值为“上”
等于真正的
,“关闭”
等于假
.因此,您可以将此属性的值用作逻辑值。该值存储为类型的on/off逻辑值matlab.lang.OnOffSwitchState
.
此属性决定是否可以中断正在运行的回调。有两种回调状态需要考虑:
的运行Callback是当前正在执行的Callback。
的打断回调是试图中断正在运行的回调的回调。
MATLAB在执行处理回调队列的命令时确定回调中断行为。这些命令包括drawnow
,数字
,uifigure
,getframe
,等待
,暂停
.
如果正在运行的回调不包含这些命令之一,则不会发生中断。MATLAB首先完成运行回调的执行,然后再执行中断回调。
如果正在运行的回调包含这些命令之一,则可中断
属性决定是否发生中断:
如果的值
可中断
是“关闭”
,则不发生中断。相反,BusyAction
属性确定中断回调是被丢弃还是添加到回调队列。如果的值
可中断
是“上”
,则中断。下一次MATLAB处理回调队列时,它将停止正在运行的回调的执行,并执行中断的回调。中断回调完成后,MATLAB继续执行正在运行的回调。
请注意
回调中断和执行在以下情况下表现不同:
如果中断回调是
DeleteFcn
,CloseRequestFcn
,或SizeChangedFcn
回调函数时,中断发生,而不管可中断
属性值。方法当前正在执行
等待
函数,则中断发生而不管可中断
属性值。如果中断回调属于
计时器
对象,则回调函数将根据调度执行,而不管可中断
属性值。
BusyAction
- - - - - -回调排队
“队列”
(默认)|“取消”
回调队列,指定为“队列”
或“取消”
.的BusyAction
属性决定MATLAB如何处理中断回调的执行。有两种回调状态需要考虑:
的运行Callback是当前正在执行的Callback。
的打断回调是试图中断正在运行的回调的回调。
的BusyAction
属性仅在满足以下两个条件时确定回调排队行为:
在这些条件下,BusyAction
拥有中断回调的对象的属性决定了MATLAB如何处理中断回调。的可能值BusyAction
属性:
“队列”
—将中断的回调放到队列中,待正在运行的回调执行完成后再处理。“取消”
—不执行中断回调。
BeingDeleted
- - - - - -删除状态
开/关逻辑值
此属性是只读的。
删除状态,作为类型的on/off逻辑值返回matlab.lang.OnOffSwitchState
.
MATLAB设置BeingDeleted
财产“上”
当DeleteFcn
回调开始执行。的BeingDeleted
属性仍然设置为“上”
直到组件对象不再存在。
的值BeingDeleted
属性在查询或修改对象之前验证对象是否即将被删除。
父/子
父
- - - - - -父容器
数字
对象(默认)|面板
对象|选项卡
对象|ButtonGroup
对象|GridLayout
对象
父容器,指定为数字
对象创建。uifigure
函数,或者它的子容器之一:选项卡
,面板
,ButtonGroup
,或GridLayout
.如果没有指定容器,MATLAB将调用uifigure
函数创建一个新的数字
对象,该对象用作父容器。
HandleVisibility
- - - - - -对象句柄的可见性
“上”
(默认)|“回调”
|“关闭”
对象句柄的可见性,指定为“上”
,“回调”
,或“关闭”
.
此属性控制对象在其父对象的子列表中的可见性。当一个对象在其父对象的子列表中不可见时,通过搜索对象层次结构或查询属性获取对象的函数将不会返回该对象。这些函数包括得到
,findobj
,clf
,关闭
.对象即使不可见也是有效的。如果可以访问对象,就可以设置和获取其属性,并将其传递给对对象进行操作的任何函数。
HandleVisibility价值 | 描述 |
---|---|
“上” |
对象总是可见的。 |
“回调” |
对象在回调或回调调用的函数中可见,但在从命令行调用的函数中不可见。此选项阻止在命令行访问对象,但允许回调函数访问它。 |
“关闭” |
这个物体在任何时候都是看不见的。此选项对于防止另一个函数对UI的意外更改非常有用。设置HandleVisibility 来“关闭” 在函数执行期间暂时隐藏对象。 |
标识符
类型
- - - - - -图形对象的类型
“uibutton”
此属性是只读的。
图形对象的类型,返回为“uibutton”
.
标签
- - - - - -对象标识符
”
(默认)|特征向量|字符串标量
对象标识符,指定为字符向量或字符串标量。您可以指定一个惟一的标签
值作为对象的标识符。方法在代码中的其他地方需要访问对象时,可以使用findobj
方法搜索对象标签
价值。
用户数据
- - - - - -用户数据
[]
(默认)|数组
用户数据,指定为任意MATLAB数组。例如,您可以指定标量、向量、矩阵、单元格数组、字符数组、表或结构。使用此属性可在对象上存储任意数据。
如果您在应用程序设计器中工作,请在应用程序中创建公共或私有属性以共享数据,而不是使用用户数据
财产。有关更多信息,请参见在应用设计器应用中共享数据.
版本历史
MATLAB命令
你点击了一个对应于这个MATLAB命令的链接:
在MATLAB命令窗口中输入该命令来运行该命令。Web浏览器不支持MATLAB命令。金宝app
您也可以从以下列表中选择一个网站:
如何获得最佳的网站性能
选择中国站点(中文或英文)以获得最佳站点性能。其他MathWorks国家站点没有针对您所在位置的访问进行优化。