Main Content

本页翻译不是最新的。点击此处可查看最新英文版本。

uicheckbox

创建复选框组件

全页折叠

语法

cbx = uicheckbox
cbx = uicheckbox(parent)
cbx = uicheckbox(___,Name,Value)

说明

cbx = uicheckbox 在新图窗窗口中创建一个复选框，并返回 CheckBox 对象。MATLAB® 调用 uifigure 函数来创建该图窗。

示例

cbx = uicheckbox(parent) 在指定的父容器中创建复选框。父容器可以是使用 uifigure 函数创建的 Figure 或其子容器之一。

示例

cbx = uicheckbox(___,Name,Value) 使用一个或多个 Name,Value 对组参数指定 CheckBox 属性。可将此选项与上述语法中的任何输入参数组合一起使用。

示例

全部折叠

创建复选框。

fig = uifigure;
cbx = uicheckbox(fig);

Check box component in a UI figure window. The check box has the text "Check box" to its right.

创建一个面板。然后在面板上创建一个复选框。

fig = uifigure;
pnl = uipanel(fig);
cbx = uicheckbox(pnl);

Check box component in a panel in a UI figure window

创建一个复选框并指定属性值。

fig = uifigure;
cbx = uicheckbox(fig, 'Text','Show Value',...
                  'Value', 1,...
                  'Position',[150 50 102 15]);

Check box component in a UI figure window. The check box is selected and has the text "Show Value" to its right.

清除复选框。

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，然后选中该复选框。第三个单选按钮被禁用。

Check box component and radio button group in a UI figure window. The check box is selected and the bottom radio button in the button group is disabled.

输入参数

全部折叠

父容器，指定为使用 uifigure 函数创建的 Figure 对象或其子容器之一：Tab、Panel、ButtonGroup 或 GridLayout。如果不指定父容器，MATLAB 会调用 uifigure 函数创建新 Figure 对象充当父容器。

名称-值参数

将可选的参数对组指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参数名称，Value 是对应的值。名称-值参数必须出现在其他参数之后，但参数对组的顺序无关紧要。

在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。

示例： 'Value',1 指定显示的复选框带有选中标记。

此处所列的属性只是可用属性中的一部分。有关完整列表，请参阅 CheckBox 属性。

复选框的状态，指定为 0 (false) 或 1 (true)。当 Value 属性设置为 1 时，复选框处于选中状态。当 Value 属性设置为 0 时，复选框处于清除状态。

更改值后执行的回调，指定为下列值之一：

  • 函数句柄。

  • 第一个元素是函数句柄的元胞数组。元胞数组中的后续元素是传递到回调函数的参数。

  • 包含有效 MATLAB 表达式的字符向量（不推荐）。MATLAB 在基础工作区计算此表达式。

当用户选中或清除 App 中的复选框时，将会执行此回调。如果以编程方式更改复选框值，将不会执行此回调。

此回调函数可以访问有关用户与复选框的交互的特定信息。MATLAB 将 ValueChangedData 对象中的此信息作为第二个参数传递给回调函数。在 App 设计工具中，该参数名为 event。您可以使用圆点表示法查询对象属性。例如，event.PreviousValue 返回复选框的上一个值。ValueChangedData 对象不可用于指定为字符向量的回调函数。

下表列出了 ValueChangedData 对象的属性。

属性值
Value复选框在 App 用户最近一次与它交互之后的值。
PreviousValue复选框在 App 用户最近一次与它交互之前的值。
Source执行回调的组件。
EventName'ValueChanged'

有关编写回调的详细信息，请参阅App 设计工具中的回调。

复选框相对于父级的位置和大小，指定为向量 [left bottom width height]。此表介绍该向量中的每个元素。

元素描述
left父容器的内部左边缘与复选框的外部左边缘之间的距离
bottom父容器的内部下边缘与复选框的外部下边缘之间的距离
width复选框的左右外部边缘之间的距离
height复选框的上下外部边缘之间的距离

Position 值相对于父容器的可绘制区域。可绘制区域是指容器边框内的区域，不包括装饰元素（如菜单栏或标题）所占的区域。

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

示例： [200 200 102 15]

版本历史记录

在 R2016a 中推出

全部展开

另请参阅

函数

属性

工具