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]);

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

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

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

tb3.Value = true;

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

font = tb3.FontName
font =

Helvetica

输入参数

全部折叠

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

名称-值对组参数

指定可选的、以逗号分隔的 Name,Value 对组参数。Name 为参数名称,Value 为对应的值。Name 必须放在引号中。您可采用任意顺序指定多个名称-值对组参数,如 Name1,Value1,...,NameN,ValueN 所示。

示例: '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 真彩色图像数组。如果指定文件名,它可以是 MATLAB 路径中的图像文件名或图像文件的完整路径。如果您计划与他人共享某个 App,请将图像文件放在 MATLAB 路径中以便于打包 App。

支持的图像格式包括 JPEG、PNG、GIF、SVG 或 m×n×3 真彩色图像数组。有关真彩色图像数组的详细信息,请参阅图像类型

  • 如果按钮文本用尽了 Position 属性值指定的所有空间,MATLAB 将不显示图标。

  • 如果还有一些空间留给图标,MATLAB 将根据需要缩小图像以适合该空间。

示例: 'icon.png' 指定 MATLAB 路径中的图标文件。

示例: 'C:\Documents\icon.png' 指定图像文件的完整路径。

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

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

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

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

提示

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

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

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

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

在 R2016a 中推出