Main Content

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

uiradiobutton

创建单选按钮组件

说明

rb = uiradiobutton 在按钮组中创建一个单选按钮,并返回 RadioButton 对象。MATLAB® 调用 uifigure 函数来创建该按钮组的父图窗。

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

示例

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

示例

全部折叠

在窗口中创建一个按钮组。

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

创建三个 RadioButton 对象,并指定每个对象的父级和位置。

rb1 = uiradiobutton(bg,'Position',[10 60 91 15]);
rb2 = uiradiobutton(bg,'Position',[10 38 91 15]);
rb3 = uiradiobutton(bg,'Position',[10 16 91 15]);

Button group with three radio buttons in a UI figure window. The top radio button in the group is selected. Each radio button has the text "Radio Button" to its right.

更改与每个单选按钮关联的文本。

rb1.Text = 'English';
rb2.Text = 'French';
rb3.Text = 'German';

Button group with three radio buttons in a UI figure window. The radio buttons have text "English", "French", and "German".

将单选按钮选择更改为 German。

rb3.Value = true;

Button group with three radio buttons in a UI figure window. The radio button with text "German" is selected.

确定单选按钮文本 German 的字体名称。

font = rb3.FontName
font =

Helvetica

输入参数

全部折叠

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

名称-值参数

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

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

示例: 'Text', 'French' 指定在单选按钮旁边显示文本“French”。

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

单选按钮的状态,指定为 1 (true) 或 0 (false)。在按钮组中,一次只能选择一个按钮。默认情况下,添加到按钮组中的第一个单选按钮的状态为 1。之后添加到同一按钮组中的按钮默认状态都为 0

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

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

注意

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

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

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

元素描述
left按钮组的内部左边缘与单选按钮的外部左边缘之间的距离
bottom按钮组的内部下边缘与单选按钮的外部下边缘之间的距离
width单选按钮的左右外部边缘之间的距离(包含文本)
height单选按钮的上下外部边缘之间的距离

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

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

提示

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

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

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

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

版本历史记录

在 R2016a 中推出

全部展开