主要内容

uibuttongroup

创建按钮组以管理单选按钮和切换按钮

描述

bg = uibuttongroup在当前图形中创建一个按钮组,并返回ButtonGroup对象。如果没有可用的图形,MATLAB®调用数字命令,创建一个。

例子

bg = uibuttongroup (名称,值使用一个或多个名称值对参数指定按钮组属性值。

bg = uibuttongroup (父母在指定的父容器中创建按钮组。属性创建的图形可以是父容器数字uifigure函数或子容器(如面板)。属性值对uibuttongroup略有不同,这取决于应用程序是否是用数字uifigure函数。欲了解更多信息,请参阅名称 - 值对参数

例子

bg = uibuttongroup (父母名称,值指定父容器和一个或多个属性值。

例子

全部收缩

当用户在按钮组中选择不同的单选按钮时,在MATLAB命令窗口中显示先前和当前的按钮选择。

复制并粘贴此代码到编辑器,并运行它,看看它是如何工作的。

函数Myui bg = uibuttongroup(“可见”“关闭”...“位置”,[0 0 .2 1],...“SelectionChangedFcn”, @bselection);%的按钮组中创建三个单选按钮。R1 = uicontrol(BG,'风格'...“radiobutton”...“字符串”选项1的...“位置”,[10 350 100 30],...“HandleVisibility”“关闭”);R2 = uicontrol(BG,'风格'“radiobutton”...“字符串”选项2的...“位置”,[10 250 100 30],...“HandleVisibility”“关闭”);r3 = uicontrol (bg,'风格'“radiobutton”...“字符串”选项3的...“位置”,[10 150 100 30],...“HandleVisibility”“关闭”);%在创建子对象后使uibuttongroup可见。bg.Visible ='在'函数bselection(来源、事件)disp ([”前,“event.OldValue.String]);disp ([”目前,“event.NewValue.String]);disp ('------------------');结尾结尾

bselection功能显示的OldValueNewValue的属性事件

应用程序有三个分组单选按钮,标签为选项1,选项2和选项3。选中第一个按钮。

可滚动属性允许在边框外有组件的按钮组内滚动。控件创建的图形中只有按钮组可以滚动uifigure函数。App Designer使用这种类型的图形来创建应用程序。

在图形中创建按钮组。添加六个切换按钮,前三个位于按钮组的上边框外。

无花果= uifigure;bg = uibuttongroup(图,“位置”[20 20 196 135]);TB1 = uitogglebutton(BG,“位置”,[11 165 140 22],“文本”'一');tb2 = uitogglebutton (bg,“位置”[11 140 140 22]“文本”“两个”);tb3 = uitogglebutton (bg,“位置”,[11 115 140 22],“文本”'三');TB4 = uitogglebutton(BG,“位置”,[11 90 140 22],“文本”“四”);tb5 = uitogglebutton (bg,“位置”,[11 65 140 22],“文本”“五”);TB6 = uitogglebutton(BG,“位置”,[11 40 140 22],“文本”“6”);

带有六个切换按钮的按钮组的应用程序。第一个、第二个和第三个按钮的一部分是不可见的。

通过设置可滚动属性'在'.默认情况下,滚动框显示在顶部。

bg.Scrollable ='在'

可滚动按钮组。左边的滚动条被滚动到顶部,所有的按钮都是可见的。选中第一个按钮。

输入参数

全部收缩

父容器,指定为与任一所创建的图数字uifigure函数或子容器:

  • 面板、选项卡和按钮组可以是任意一种图形中的容器。

  • 网格布局可以只集装箱在创建人物uifigure函数。

名称值参数

例子:uibuttongroup('标题','选项')指定按钮组标题为选项

指定可选的用逗号分隔的对名称,值参数。的名字是参数的名称和价值为对应值。的名字必须出现在单引号内(' ')。您可以指定多个名称和值对作为参数Name1, Value1,…,的家

笔记

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

标题,指定为字符向量、字符串标量或分类数组。如果将此属性指定为分类数组,则MATLAB只显示数组中的第一个元素。

MATLAB不能解释垂直斜线(“|”)字符作为一个换行符,它显示为在标题的垂直斜线。

如果你想指定一个Unicode®字符,将Unicode十进制码传递给字符函数。例如,[炭 '的倍数'(960)]显示为的倍数π

背景颜色,指定为一个RGB三元组,一个十六进制颜色代码,或在表中列出的颜色选项之一。

RGB三联体和十六进制颜色代码在指定自定义颜色时很有用。

  • RGB三元组是一个由三个元素组成的行向量,其元素指定颜色的红色、绿色和蓝色组件的强度。强度必须在这个范围内[0,1];例如,(0.4 0.6 0.7)

  • 十六进制颜色代码是以哈希符号开头的字符向量或字符串标量(),然后是3个或6个十六进制数字,其范围可以是0.F.这些值不区分大小写。因此,颜色是代码“# FF8800”'#ff8800'“# F80”,'#F80'是等价的。

或者,您可以通过名称指定一些常见的颜色。该表列出了已命名的颜色选项、等价的RGB三联体和十六进制颜色代码。

颜色名称 短名称 RGB三元 十六进制颜色代码 外观
'红色的' 'R' (1 0 0) '#FF0000'

样品的颜色为红色

'绿色' ‘g’ (0 1 0) '#00FF00'

样品的颜色为绿色

“蓝” “b” (0 0 1) '#0000FF'

样品的颜色是蓝色的

“青色” “c” (0 1 1) “# 00飞行符”

样品的颜色为青色

“红色” “米” (1 0 1) “#就”

洋红色的样品

“黄色” 'Y' [1 1 0] '#FFFF00'

样品的颜色为黄色

“黑” “k” (0 0 0) # 000000的

样品的颜色为黑色

'白色的' 'W' [1 1 1] '#FFFFFF'

色白样本

以下是MATLAB在许多类型的绘图中使用的默认颜色的RGB三联体和十六进制颜色代码。

RGB三元 十六进制颜色代码 外观
[0 0.4470 0.7410] “# 0072 bd”

RGB三元组样本[0 0.4470 0.7410],呈现深蓝色

[0.8500 0.3250 0.0980] '#D95319'

RGB三元组样本[0.8500 0.3250 0.0980],呈暗橙色

(0.9290 0.6940 0.1250) “# EDB120”

RGB三元组样本[0.9290 0.6940 0.1250],呈暗黄色

(0.4940 0.1840 0.5560) '#7E2F8E'

RGB三元[0.4940 0.1840 0.5560],其表现为暗紫色的样品

(0.4660 0.6740 0.1880) “# 77 ac30”

RGB三元[0.4660 0.6740 0.1880],其表现为中等绿色的样品

(0.3010 0.7450 0.9330) “# 4 dbeee”

样品RGB三片[0.3010 0.7450 0.9330],显示为浅蓝色

(0.6350 0.0780 0.1840) “# A2142F”

RGB三元组样本[0.6350 0.0780 0.1840],呈暗红色

当前选择的单选按钮或切换按钮,指定为单选按钮或者一个切换按钮对象uifigure基于应用程序,或UIControl对象数字的应用程序。

得到该属性的值,以确定当前哪个按钮被按钮组内选择。

设置此属性的值以更改当前选定的按钮。当您使用此属性更改选择时,MATLAB将调整价值属性相应按钮组内的其他按钮。

例如,假设您的按钮组包含三个单选按钮,您将SelectedObject属性radiobutton3.MATLAB设置价值属性。单选按钮如下:

  • radiobutton1。价值= false;

  • radiobutton2。价值= false;

  • radiobutton3.Value = TRUE;

换句话说,设置SelectedObject属性的作用与设置价值属性。

选择改变回调,指定为以下值之一:

  • 一个处理函数。

  • 的细胞阵列,其中所述第一元件是一个功能句柄。在单元阵列中随后的元件是要传递给回调函数的参数。

  • (不推荐)包含有效MATLAB表达的字符向量。MATLAB评估在基工作区这个表达式。

当用户在应用程序的按钮组中选择一个不同的按钮时,这个回调会执行。如果是单选按钮或切换按钮,它不会执行价值通过编程方式属性更改。

这个回调函数可以访问有关用户与按钮交互的特定信息。MATLAB将这个信息传递到SelectionChangedData对象作为第二个参数回调函数。在应用程序设计,参数被称为事件.您可以查询使用点符号对象属性。例如,事件。NewValue返回当前选择的按钮。这SelectionChangedData对象不可用回调指定为字符向量的功能。

下表列出的属性SelectionChangedData对象。

财产

描述

的OldValue

之前选择的按钮

NewValue

目前选定的按钮

执行回调的组件

EventName

“SelectionChanged”

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

按钮组的位置和大小,包括边框和标题,指定为窗体的矢量[左下角宽度高度].此表描述向量中的每个元素。

元素 描述
剩下 父容器的左内边缘到按钮组的左外边缘的距离
父容器的内底边到按钮组的外底边的距离
宽度 按钮组左右外边缘之间的距离
高度 按钮组的上下外缘之间的距离

所有的测量单位由指定的单位财产。

位置值是相对于绘制区域父容器的。该绘制区域是容器的边框内的区域,不包括占用面积的装饰,例如菜单栏或标题。

计量单位,规定为在此表中的值之一。

单位价值 描述
'像素'(默认)

在Windows上,像素距离与系统分辨率无关®麦金塔电脑系统:

  • 在Windows系统中,像素是一英寸的1 /第96。

  • 麦金塔电脑在系统中,一个像素是1/72英寸。

在Linux上®系统,像素的大小是由您的系统分辨率决定。

“规范化”

这些单元被归一化相对于该父容器。容器的左下角映射到(0,0)右上角映射到(1,1)

“英寸” 英寸。
“厘米” 厘米。
“点” 点。一点等于一英寸的1/72。

建议值为'像素',因为大多数构建功能的MATLAB应用程序都是用像素来度量距离的。控件创建的网格布局管理器可以创建基于父容器大小的按钮组uigridlayout函数。欲了解更多信息,请参阅奠定了应用程序编程

数字基于应用程序

对于应用程序按钮组使用创建数字功能的默认值单位“规范化”

此外,您可以指定单位作为'人物'.字符单位是基于图形根对象的默认uicontrol字体:

  • 字符宽度=字母的宽度X

  • 字符高度=两行文本基线之间的距离。

要访问默认的uicontrol字体,请使用得到(格鲁特, 'defaultuicontrolFontName')集(大的,“defaultuicontrolFontName”)

提示

  • A按钮组可以包含任何用户界面组件的类型,但它仅管理的单选按钮和切换按钮的选择。

  • 当应用程序用户选择按钮组中的单选按钮或切换按钮时,使程序响应。定义一个SelectionChangedFcn按钮组的回调函数。不能为单个按钮定义回调。

  • 要确定选择了哪个单选按钮或切换按钮,请查询SelectedObject属性。您可以在代码中的任何地方执行此查询。

  • 如果你设置可见按钮组对象的属性,以“关闭”,那么任何子对象它包含(按钮,其他按钮组等)成为与母按钮组沿不可见的。然而可见属性值每个子对象的。

之前介绍过的R2006a