Main Content

uitogglebutton

创建切换按钮组件

说明

tb = uitogglebutton 在按钮组中创建一个切换按钮,并返回 ToggleButton 对象。MATLAB® 调用 uifigure 函数来创建该按钮组的父图窗。

示例

tb = uitogglebutton(parent) 在指定的按钮组内创建切换按钮。按钮组必须是使用 uifigure 函数创建的 Figure 的子级,或者是图窗中以下子容器的父容器:TabPanelButtonGroupGridLayout

示例

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

示例

全部折叠

要创建切换按钮,首先要创建一个图窗窗口和一个按钮组,以包含要创建的按钮。

fig = uifigure('Position',[680 678 398 271]);
bg = uibuttongroup(fig,'Position',[137 113 123 85]);

创建三个切换按钮,并指定每个按钮的位置。

tb1 = uitogglebutton(bg,'Position',[10 50 100 22]);
tb2 = uitogglebutton(bg,'Position',[10 28 100 22]);
tb3 = uitogglebutton(bg,'Position',[10 6 100 22]);

Three toggle buttons in a button group. Each button has the text "Toggle Button" and the first button is selected.

更改与每个切换按钮关联的文本。

tb1.Text = 'English';
tb2.Text = 'French';
tb3.Text = 'German';

Three toggle buttons in a button group. The buttons have the text "English", "French", and "German". The "English" button is selected.

以编程方式将切换按钮选择更改为 German。

tb3.Value = true;

Three toggle buttons in a button group. The buttons have the text "English", "French", and "German". The "German" button is selected.

确定切换按钮文本 German 的字体名称。

font = tb3.FontName
font =

Helvetica

输入参数

全部折叠

父容器,指定为 ButtonGroup 对象。ButtonGroup 必须是使用 uifigure 函数创建的 Figure 的父容器,或者是 uifigure 的子容器,例如:TabPanelButtonGroupGridLayout

名称-值参数

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

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

示例: 'Text', 'French' 指定在切换按钮上显示文本“French”。

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

切换按钮的状态,指定为 0(未按下)或 1(按下)。在给定的按钮组中,一次只能选择(按下)一个切换按钮。当 Value 属性设置为 1 时,切换按钮显示为被按下。默认情况下,在按钮组中添加的第一个按钮的状态为 1。之后添加到同一按钮组中的按钮默认状态都为 0

ToggleButtonValue 属性更改为 1 时,先前选择的 ToggleButtonValue 属性将更改为 0。此外,ButtonGroupSelectedObject 属性值将更新。

如果您以编程方式将 ToggleButtonValue 属性更改为 0,MATLAB 会将添加ButtonGroup 的第一个 ToggleButtonValue 属性设置为 1。如果添加的第一个 ToggleButton 就是您以编程方式将 Value 属性设置为 0 的那一个,则 MATLAB 会将添加到 ButtonGroup 中的 ToggleButtonValue 属性设置为 1

注意

添加ButtonGroup 中的第一个 ToggleButton 不一定是 ButtonGroupChildren 属性中列出的第一个 ToggleButton

按钮标签,指定为字符向量、字符向量元胞数组、字符串标量、字符串数组或一维分类数组。如果指定字符向量或字符串标量,将为按钮添加单行文本标签。如果使用元胞数组或字符串数组,将为按钮添加多行文本标签。数组中的每个元素代表一行文本。如果将此属性指定为分类数组,MATLAB 将使用数组中的值,而不是完整的类别集。

预定义或自定义图标,指定为字符向量、字符串标量或 m×n×3 真彩色图像数组。

预定义图标

下表列出了用于指定预定义图标的值。

图标
''(默认值)不显示任何图标。
'question'

Question icon

'info'

Info icon

'success'

Success icon

'warning'

Warning icon

'error'

Error icon

自定义图标

可将自定义图标指定为下列值之一:

  • 字符向量或字符串标量,指定 MATLAB 路径中的 SVG、JPEG、GIF 或 PNG 图像的文件名。也可以指定图像文件的完整路径。

  • m×n×3 真彩色图像数组。有关详细信息,请参阅 图像类型

如果您计划与他人共享某个 App,请将图像文件放在 MATLAB 路径中以便于打包 App。

如果按钮文本用尽了 Position 属性值指定的所有空间,MATLAB 将不显示图标。如果还有一些空间留给图标,MATLAB 将根据需要缩小图像以适合该空间。

按钮的位置和大小,指定为 [left bottom width height] 形式的向量。此表介绍该向量中的每个元素。

元素描述
left按钮组的内部左边缘与按钮的外部左边缘之间的距离
bottom按钮组的内部下边缘与按钮的外部下边缘之间的距离
width按钮的左右外部边缘之间的距离
height按钮的上下外部边缘之间的距离

Position 值基于按钮组的可绘制区域。可绘制区域是指按钮组边框内的区域,不包括标题所占的区域。

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

提示

  • 虽然按钮组可以包含任何类型的 UI 组件,但只能控制单选按钮和切换按钮的选择。

  • 要使您的程序在 App 用户选择按钮组中的单选按钮或切换按钮时做出响应,请为 ButtonGroup 对象定义一个 SelectionChangedFcn 回调函数。不能定义对单个按钮的回调。

  • 要确定当前选择了哪个单选按钮或切换按钮,请查询 ButtonGroup 对象的 SelectedObject 属性。可以在代码中的任何位置执行此查询。

  • 如果将 ButtonGroup 对象的 Visible 属性设置为 'off',该对象包含的任何子对象都将与父 ButtonGroup 一起变得不可见。但是,每个子对象的 Visible 属性值不受影响。

版本历史记录

在 R2016a 中推出

全部展开