主要内容

uicheckbox

创建复选框组件

描述

cbx= uicheckbox在新图形窗口中创建复选框并返回复选框对象。MATLAB®调用uifigure函数创建图形。

例子

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

例子

cbx= uicheckbox (___名称,值指定复选框属性使用一个或多个名称,值对参数。将此选项与前面语法中的任何输入参数组合一起使用。

例子

全部折叠

创建一个复选框。

无花果= uifigure;cbx = uicheckbox(图);

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

无花果= uifigure;pnl = uipanel(图);cbx = uicheckbox (pnl);

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

无花果= uifigure;cbx = uicheckbox(图,“文本”“显示值”...“价值”, 1...“位置”,[150 50 102 15]);

清除复选框。

cbx。值= 0;

确定复选框文本的字体大小。

fsize = cbx。字形大小
fsize = 12

创建单选按钮组和复选框。当应用程序用户选中复选框时,单选按钮将被禁用。

保存以下代码disableRadioButton.m在MATLAB路径上。

此代码创建一个包含单选按钮组和复选框的窗口。当应用程序用户清除复选框时,复选框ValueChangedFcn禁用第三个单选按钮。

函数disableRadioButton%创建图形窗口:无花果= uifigure (“位置”,[100 100 229 276]);创建一个按钮组和单选按钮:bg = uibuttongroup (“父”无花果,...“位置”,[56 77 123 85]);rb1 = uiradiobutton (bg,“位置”,[10 60 91 15]);而已= uiradiobutton (bg,“位置”,[10 38 91 15]);rb3 = uiradiobutton (bg,“位置”,[10 16 91 15]);%创建复选框:cbx = uicheckbox(图,“位置”,[55 217 102 15],...“ValueChangedFcn”@ (cbx、事件)cBoxChanged (cbx rb3));结束%为ValueChangedFcn回调函数创建函数:函数cBoxChanged(cbx,rb3) val = cbx. value;如果val rb3。使=“关闭”其他的rb3。使=“上”结束结束

运行disableRadioButton,然后选择复选框。第三个单选按钮被禁用。

输入参数

全部折叠

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

名称-值参数

指定可选的逗号分隔的对名称,值参数。的名字参数名和价值为对应值。的名字必须出现在引号内。可以以任意顺序指定多个名称和值对参数Name1, Value1,…,的家

例子:“价值”1指定复选框显示时带有复选标记。

这里列出的属性是可用属性的子集。有关完整列表,请参见复选框属性

复选框的状态,指定为0(虚假的)或1(真正的)。当价值属性设置为1,复选框被选中。当价值属性设置为0时,复选框未选中。

Value changed callback,指定为以下值之一:

  • 一个处理函数。

  • 单元格数组,其中第一个元素是函数句柄。cell数组中的后续元素是要传递给回调函数的参数。

  • 包含有效MATLAB表达式的字符向量(不推荐)。MATLAB在基本工作空间中计算这个表达式。

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

这个回调函数可以访问有关用户与复选框交互的特定信息。MATLAB将这个信息传递到ValueChangedData对象作为回调函数的第二个参数。在App Designer中,参数被调用事件.可以使用点表示法查询对象属性。例如,事件。PreviousValue返回复选框的前一个值。的ValueChangedData对象不可用于指定为字符向量的回调函数。

控件的属性如下表所示ValueChangedData对象。

财产 价值
价值 复选框的值在最近的应用程序用户与它交互后。
PreviousValue 复选框的值在最近的应用程序用户与它交互之前。
执行回调的组件。
EventName “ValueChanged”

有关编写回调的更多信息,请参见在应用程序设计器中编写回调

复选框相对于父元素(指定为向量)的位置和大小[左下角宽度高度].该表描述了向量中的每个元素。

元素 描述
父容器的左内边缘到复选框的左外边缘的距离
从父容器的内底边到复选框的外底边的距离
宽度 复选框左右外缘之间的距离
高度 复选框的上下外缘之间的距离

位置值是相对于可拉的区域父容器的。绘制区域是容器边界内的区域,不包括菜单栏或标题等装饰占据的区域。

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

例子:[200 200 102 15]

另请参阅

功能

属性

介绍了R2016a