uicheckbox
创建复选框组件
说明
示例
创建复选框
创建复选框。
fig = uifigure; cbx = uicheckbox(fig);
在面板上创建复选框
创建一个面板。然后在面板上创建一个复选框。
fig = uifigure; pnl = uipanel(fig); cbx = uicheckbox(pnl);
设置和访问复选框属性值
创建一个复选框并指定属性值。
fig = uifigure; cbx = uicheckbox(fig, 'Text','Show Value',... 'Value', 1,... 'Position',[150 50 102 15]);
清除复选框。
cbx.Value = 0;
确定复选框文本的字体大小。
fsize = cbx.FontSize
fsize = 12
编写响应以下操作的代码:选中复选框
创建一个单选按钮组和一个复选框。当 App 用户选中该复选框时,单选按钮将被禁用。
请将以下代码保存到 MATLAB 路径中的 disableRadioButton.m
中。
以下代码将创建一个窗口,其中包含一个单选按钮组和一个复选框。当 App 用户清除该复选框时,复选框 ValueChangedFcn
将禁用第三个单选按钮。
function disableRadioButton % Create a figure window: fig = uifigure('Position',[100 100 229 276]); % Create a button group and radio buttons: bg = uibuttongroup('Parent',fig,... 'Position',[56 77 123 85]); rb1 = uiradiobutton(bg,'Position',[10 60 91 15]); rb2 = uiradiobutton(bg,'Position',[10 38 91 15]); rb3 = uiradiobutton(bg,'Position',[10 16 91 15]); % Create a check box: cbx = uicheckbox(fig,'Position',[55 217 102 15],... 'ValueChangedFcn',@(cbx,event) cBoxChanged(cbx,rb3)); end % Create the function for the ValueChangedFcn callback: function cBoxChanged(cbx,rb3) val = cbx.Value; if val rb3.Enable = 'off'; else rb3.Enable = 'on'; end end
运行 disableRadioButton
,然后选中该复选框。第三个单选按钮被禁用。
输入参数
parent
— 父容器
Figure
对象 (默认) | Tab
对象 | Panel
对象 | ButtonGroup
对象 | GridLayout
对象
父容器,指定为使用 uifigure
函数创建的 Figure
对象或其子容器之一:Tab
、Panel
、ButtonGroup
或 GridLayout
。如果不指定父容器,MATLAB 会调用 uifigure
函数创建新 Figure
对象充当父容器。
名称-值参数
将可选的参数对组指定为 Name1=Value1,...,NameN=ValueN
,其中 Name
是参数名称,Value
是对应的值。名称-值参数必须出现在其他参数之后,但参数对组的顺序无关紧要。
在 R2021a 之前,使用逗号分隔每个名称和值,并用引号将 Name
引起来。
示例: 'Value',1
指定显示的复选框带有选中标记。
此处所列的属性只是可用属性中的一部分。有关完整列表,请参阅 CheckBox 属性。
Value
— 复选框的状态
0 (默认) | 1
复选框的状态,指定为 0
(false) 或 1
(true)。当 Value
属性设置为 1
时,复选框处于选中状态。当 Value
属性设置为 0
时,复选框处于清除状态。
ValueChangedFcn
— 更改值后执行的回调
[]
(默认) | 函数句柄 | 元胞数组 | 字符向量
更改值后执行的回调,指定为下列值之一:
函数句柄。
第一个元素是函数句柄的元胞数组。元胞数组中的后续元素是传递到回调函数的参数。
包含有效 MATLAB 表达式的字符向量(不推荐)。MATLAB 在基础工作区计算此表达式。
当用户选中或清除 App 中的复选框时,将会执行此回调。如果以编程方式更改复选框值,将不会执行此回调。
此回调函数可以访问有关用户与复选框的交互的特定信息。MATLAB 将 ValueChangedData
对象中的此信息作为第二个参数传递给回调函数。在 App 设计工具中,该参数名为 event
。您可以使用圆点表示法查询对象属性。例如,event.PreviousValue
返回复选框的上一个值。ValueChangedData
对象不可用于指定为字符向量的回调函数。
下表列出了 ValueChangedData
对象的属性。
属性 | 值 |
---|---|
Value | 复选框在 App 用户最近一次与它交互之后的值。 |
PreviousValue | 复选框在 App 用户最近一次与它交互之前的值。 |
Source | 执行回调的组件。 |
EventName | 'ValueChanged' |
有关编写回调的详细信息,请参阅App 设计工具中的回调。
Position
— 复选框的位置和大小
[100 100 84 22]
(默认) | [left bottom width height]
复选框相对于父级的位置和大小,指定为向量 [left bottom width height]
。此表介绍该向量中的每个元素。
元素 | 描述 |
---|---|
left | 父容器的内部左边缘与复选框的外部左边缘之间的距离 |
bottom | 父容器的内部下边缘与复选框的外部下边缘之间的距离 |
width | 复选框的左右外部边缘之间的距离 |
height | 复选框的上下外部边缘之间的距离 |
Position
值相对于父容器的可绘制区域。可绘制区域是指容器边框内的区域,不包括装饰元素(如菜单栏或标题)所占的区域。
所有测量值都以像素为单位。
示例: [200 200 102 15]
版本历史记录
在 R2016a 中推出R2020b: 复选框文本换行
当 UI 组件的宽度小于要显示的文本的宽度时,使用 WordWrap
属性可防止文本在水平方向上被裁剪。将 WordWrap
属性设置为 'on'
会将文本分成若干新行,以便每行都适合组件宽度。它会尽可能避免拆分词语。当该属性设置为 'off'
时,文本不会换行。
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)