主要内容

buttongroup属性

控制按钮组外观和行为Uifigure.的应用程序

按钮组是管理单选按钮和切换按钮的专用选择的容器。属性控制按钮组的外观和行为。使用点符号引用特定的对象和属性。

无花果= uifigure;bg = uibuttongroup(图);bg。Title =“选项”;

此处列出的属性在App Designer中的按钮组,或在创建的应用程序中有效Uifigure.功能。对于指南中使用的按钮组,或在创建的应用程序中数字功能,请参阅buttongroup属性

标题

全部展开

标题,指定为字符向量,字符串标量或分类数组。如果将此属性指定为分类数组,Matlab®仅在数组中显示第一个元素。

MATLAB不会解释垂直斜杠(“|”)字符作为排队中断,它显示为标题中的垂直斜杠。

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

标题的位置,指定为“lefttop”'Centertop', 或者'右特

颜色和造型

全部展开

标题颜色,指定为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) “#就”

'黄色的' '是' [1 1 0] '#ffff00'

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

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

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

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

[0.8500 0.3250 0.0980] '#d95319'

(0.9290 0.6940 0.1250) “# EDB120”

(0.4940 0.1840 0.5560) '#7e2f8e'

(0.4660 0.6740 0.1880) “# 77 ac30”

(0.3010 0.7450 0.9330) “# 4 dbeee”

(0.6350 0.0780 0.1840) “# A2142F”

背景颜色,指定为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) “#就”

'黄色的' '是' [1 1 0] '#ffff00'

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

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

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

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

[0.8500 0.3250 0.0980] '#d95319'

(0.9290 0.6940 0.1250) “# EDB120”

(0.4940 0.1840 0.5560) '#7e2f8e'

(0.4660 0.6740 0.1880) “# 77 ac30”

(0.3010 0.7450 0.9330) “# 4 dbeee”

(0.6350 0.0780 0.1840) “# A2142F”

按钮组边框,指定为'线''没有任何'

字体

全部展开

字体名称,指定为系统支持的字体名称。金宝app默认字体取决于特定的操作系统和语言环境。

如果指定的字体不可用,那么MATLAB将在应用程序运行的系统中使用可用字体中的最佳匹配。

例子:“天线”

字体大小,指定为正数。测量单位是像素。默认字体大小取决于特定的操作系统和语言环境。

例子:14.

字体重量,指定为其中一个值:

  • '普通的'- 由特定字体定义的默认重量

  • '大胆的'-厚的字符轮廓比'普通的'

并非所有字体都有粗体的字体重量。因此,指定粗体的重量可以导致正常的字体重量。

字体角度,指定为'普通的''斜体'.将此属性设置为斜体如果App用户的系统上可用,请选择字体的倾斜版本。

字体测量单位,指定为'像素'.像素的距离与Windows上的系统分辨率无关®和Macintosh系统:

  • 在Windows系统上,像素是1/96英寸。

  • 在Macintosh系统上,像素是1/72nd英寸。

  • 在Linux上®系统,像素的大小由系统分辨率确定。

交互性

全部展开

可见性状态,指定为'上'“关闭”,或作为数字或逻辑1真正的) 或者0.错误的).价值'上'相当于真正的,“关闭”相当于错误的.因此,您可以使用此属性的值作为逻辑值。该值存储为类型的开/关逻辑值matlab.lang.OnOffSwitchState

  • '上'- 显示对象。

  • “关闭”—隐藏对象,但不删除对象。您仍然可以访问不可见UI组件的属性。

让您的应用程序开始更快,设置可见财产“关闭”对于所有不需要在启动时出现的组件。

更改不可见容器的大小将触发SizeChangedFcn回调变得可见。

改变了可见属性可以不是改变的值可见子组件的属性。即使隐藏容器会导致子组件被隐藏,也是如此。

此属性是只读的。

由按钮组管理的按钮,作为数组返回单选按钮对象或数组ToggleButton.对象。

属性的所有子组件不一定返回ButtonGroup目的。如果您需要访问不是的子组件单选按钮ToggleButton.对象,使用孩子们财产。

当前选择的单选按钮或切换按钮,指定为a单选按钮或者一个ToggleButton.目的。

获取此属性的值以确定按钮组中当前选择的按钮。

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

例如,假设您的按钮组包含三个单选按钮,并且您设置selectedObject.财产radiobutton3.Matlab设置了价值每个孩子的财产单选按钮如下:

  • radiobutton1.value = false;

  • radiobutton2.value = false;

  • radiobutton3.value = true;

也就是说,设置selectedObject.属性具有与设置相同的效果价值A的财产单选按钮ToggleButton.

滚动,指定为“关闭”'上',或作为数字或逻辑1真正的) 或者0.错误的).价值'上'相当于真正的,“关闭”相当于错误的.因此,您可以使用此属性的值作为逻辑值。该值存储为类型的开/关逻辑值matlab.lang.OnOffSwitchState

将此属性设置为'上'启用容器内的滚动。但是,有额外要求:

  • 容器中的子组件必须占用比容器一次性更大的区域。

  • 不适合容器的组件必须位于容器的上方或右侧。您不能滚动到容器下方或左侧的组件。

某些类型的图表和轴不支持可滚动容器。金宝app但是,您可以将图表或轴放入非可粘的面板中,然后将面板放在可滚动容器中。有关更多信息,请参阅在App Designer中显示图形

操作状态,指定为'上'“关闭”,或作为数字或逻辑1真正的) 或者0.错误的).价值'上'相当于真正的,“关闭”相当于错误的.因此,您可以使用此属性的值作为逻辑值。该值存储为类型的开/关逻辑值matlab.lang.OnOffSwitchState

  • 如果您将此属性设置为'上',应用程序用户可以与组件交互。

  • 如果您将此属性设置为“关闭”,组件显示为灰色,表示应用程序用户无法与它交互,也不会触发回调。

改变的价值使能够属性执行的操作不是的值使能够属性用于包含在该按钮组中的UI组件。

工具提示,指定为字符向量,字符向量单元阵列,字符串数组或1-D分类阵列。使用此属性在运行时筛选组件上的指针时显示一条消息。要显示多行文本,请指定字符向量或字符串数​​组的单元格数组。阵列中的每个元素都成为单独的文本行。如果将此属性指定为分类数组,则Matlab使用数组中的值,而不是完整的类别。

上下文菜单,指定为a上下文菜单对象创建的uicontextmenu功能。右键单击组件时,请使用此属性显示上下文菜单。

位置

全部展开

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

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

所有测量值由单位属性值。

位置值相对于可拉伸区域父容器。可拉伸区域是容器边界内的区域,并且不包括装饰品(例如菜单栏或标题)所占用的区域。

此属性是只读的。

按钮组的位置和大小(不包括边框和标题),作为表单的四元素向量返回[左下角宽度高度].此表描述了向量中的每个元素。

价值 描述
剩下 父容器的左内边缘到按钮组的左内边缘的距离。
从父容器的内底边缘到按钮组的内底边缘的距离。
宽度 按钮组左右边框内边缘之间的距离。
高度 按钮组顶部和底部边界内边缘之间的距离。如果存在,则此距离不包括标题。

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

笔记

这些是在使用内在属性:

  • 内在值受到标题的存在(或不存在)、字体特征和bordertype.

  • 内在值是相对于父容器的可拉伸区域.可绘制区域是容器边界内的区域,不包括标题所占用的区域。

按钮组的位置和大小,包括边框和标题,指定为表单的四元素向量[左下角宽度高度].所有测量都是由此指定的单位单位财产。

属性值与位置属性值。

计量单位,指定为'像素'

自动调整子大小,指定为'上'“关闭”,或作为数字或逻辑1真正的) 或者0.错误的).价值'上'相当于真正的,“关闭”相当于错误的.因此,您可以使用此属性的值作为逻辑值。该值存储为类型的开/关逻辑值matlab.lang.OnOffSwitchState

  • '上'—当容器调整大小时,子组件自动调整大小。

  • “关闭”- 子组件不调整大小。

AutoResizeChildren财产影响集装箱的直接子女,而不是嵌套容器内的儿童。

要自定义调整大小行为,请设置AutoResizeChildren财产“关闭”并创建一个SizeChangedFcn容器的回调。有关更多信息,请参阅在App Designer中管理可调节的应用程序

要禁用应用程序的大小调整,请设置调整属性的数字“关闭”

布局选项,指定为gridlayoutoptions.目的。此属性指定网格布局容器的子组件的选项。如果组件不是网格布局容器的子节点(例如,它是图形或面板的子项),则此属性为空,没有效果。但是,如果组件是网格布局容器的子节点,则可以通过设置该组件将组件放置在所需的行和网格列中物业在gridlayoutoptions.目的。

例如,此代码将一个按钮组放在其父网格的第三行和第二列中。

g = uigrivlayout([4 3]);BG = UIBUTTONGROUP(G);bg.layout.row = 3;bg.layout.column = 2;

要使按钮组跨越多行或列,请指定属性作为双元素矢量。例如,此按钮组跨度列2通过3.

bg.Layout.Column = [2 3];

回调

全部展开

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

  • 功能手柄。

  • 其中第一元素是函数手柄的单元阵列。单元格数组中的后续元素是传递给回调函数的参数。

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

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

这个回调函数可以访问关于用户与按钮交互的特定信息。MATLAB通过一个SelectionChangedData.对象作为回调函数的第二个参数。在App Designer中,调用该参数事件.您可以使用点表示法查询对象属性。例如,事件。纽瓦伊返回当前选定的按钮。这SelectionChangedData.指定为字符向量的回调函数不可用对象。

下表列出了该属性SelectionChangedData.目的。

财产

描述

老瓦

之前选择的按钮

纽瓦伊

当前选择的按钮

执行回调的组件

EventName

“选择”

有关写回调的更多信息,请参阅在App Designer中写回调

大小改变回调,指定为以下值之一:

  • 功能手柄。

  • 其中第一元素是函数手柄的单元阵列。单元格数组中的后续元素是传递给回调函数的参数。

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

当容器的大小发生变化时,定义这个回调来定制应用的布局(例如,当用户调整窗口的大小时)。在其中,编写代码来调整位置子组件的财产。

笔记

SizeChangedFcn回调不会执行,除非AutoResizeChildren属性设置为“关闭”.在App Designer中,您可以制作SizeChangedFcn通过选择容器和清除的可执行文件AutoResizeChildren复选框中的检查员选项卡组件浏览器

SizeChangedFcn回调执行时执行:

  • 该容器首次可见。

  • 在其尺寸变化时,此容器可见。

  • 这个容器在其大小改变后第一次可见。这种情况发生在容器的大小发生变化时,而容器是不可见的,然后它变成可见的。

在定义时要考虑的其他重要观点SizeChangedFcn回调函数:

  • 考虑延迟显示此容器,直到所有变量SizeChangedFcn使用使用。这种做法可以防止SizeChangedFcn回调返回错误。要延迟容器的显示,请设置其可见财产“关闭”.然后,设置可见财产'上'在您定义您的SizeChangedFcn回调用途。

  • 如果您的应用程序包含嵌套容器,则它们从内部调整大小。

  • 访问从中调整大小的容器SizeChangedFcn,引用源对象(回调中的第一个输入参数)或使用gcbo.功能。

指定调整大小行为的另一种方法是创建GridLayout对象或使用App Designer中的自动回流选项。这些选项可以比使用更容易使用SizeChangedFcn回调。然而,也有一些优点SizeChangedFcn回调有这些选项。例如:

  • 将组件调整为最小或最大大小为您定义的。

  • 实现非线性调整大小的行为,例如基于父容器的大小更改组件的大小。

按钮按回调函数,指定为其中一个值:

  • 功能手柄。

  • 其中第一元素是函数手柄的单元阵列。单元格数组中的后续元素是传递给回调函数的参数。

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

有关将回调属性值指定为函数句柄,小区数组或字符向量的详细信息,请参阅如何指定回调属性值

ButtonDownFcn回调是在用户单击容器内的鼠标按钮时执行的函数。

对象创建函数,指定为其中一个值:

  • 功能手柄。

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

  • 字符矢量包含有效的matlab表达式(不推荐)。MATLAB在基础工作区中评估此表达式。

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见在App Designer中写回调

这个属性指定了当MATLAB创建对象时要执行的回调函数。MATLAB初始化所有属性值之前,执行CreateFcn回调。如果您没有指定CreateFcn属性,然后MATLAB执行一个默认创建函数。

设置CreateFcn属性对现有组件不起作用。

如果将此属性指定为函数句柄或单元格数组,则可以访问使用回调函数的第一个参数创建的对象。否则,使用gcbo.访问对象的函数。

对象删除函数,指定为其中一个值:

  • 功能手柄。

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

  • 字符矢量包含有效的matlab表达式(不推荐)。MATLAB在基础工作区中评估此表达式。

有关将回调指定为函数句柄、单元格数组或字符向量的详细信息,请参见在App Designer中写回调

此属性指定MATLAB删除对象时要执行的回调函数。Matlab执行了DeleteFcn销毁对象属性之前的回调。如果您没有指定DeleteFcn属性,然后MATLAB执行一个默认的删除函数。

如果将此属性指定为函数句柄或单元格数组,则可以使用回调函数的第一个参数访问正在删除的对象。否则,使用gcbo.访问对象的函数。

回调执行控制

全部展开

回调中断,指定为'上'“关闭”,或作为数字或逻辑1真正的) 或者0.错误的).价值'上'相当于真正的,“关闭”相当于错误的.因此,您可以使用此属性的值作为逻辑值。该值存储为类型的开/关逻辑值matlab.lang.OnOffSwitchState

此属性确定是否可以中断运行回调。有两个回调状态需要考虑:

  • 运行回调是当前正在执行的回调。

  • 打断回调是试图中断正在运行的回调的回调。

每当MATLAB调用一个回调函数时,该回调函数试图中断正在运行的回调函数(如果存在的话)。这中断拥有运行回调的对象的属性确定是否允许中断。

  • 价值'上'允许其他回调中断对象的回调。中断发生在matlab处理队列的下一个点,例如何时存在drawn数字Uifigure.getframe等待, 或者暂停命令。

    • 如果运行回调包含其中一个命令,则Matlab在该点处停止执行回调并执行中断回调。MATLAB在中断回调完成时执行运行回调。

    • 如果运行的回调不包含这些命令中的一个,那么MATLAB将在不中断的情况下完成回调的执行。

  • 价值“关闭”阻止所有中断尝试。这忙碌拥有中断回调的对象的属性确定中断呼叫是否被丢弃或放入队列中。

笔记

回调中断和执行在以下情况下的行为不同:

  • 如果中断回调是一个DeleteFcnCloseRequestFcnSizeChangedFcn回调,那么无论的内容都会发生中断中断属性值。

  • 如果正在运行的回调当前正在执行等待函数,则不管中断属性值。

  • 计时器对象按照时间表执行,而不管中断属性值。

发生中断时,MATLAB不保存属性或显示状态。例如,由此返回的对象gcagcf当另一个回调执行时,命令可能会更改。

回调队列指定为'队列'“取消”.这忙碌属性确定MATLAB如何处理中断回调的执行。有两个回调状态需要考虑:

  • 运行回调是当前正在执行的回调。

  • 打断回调是试图中断正在运行的回调的回调。

每当MATLAB调用一个回调函数时,该回调函数试图中断一个正在运行的回调函数。这中断属性确定是否允许中断。如果不允许中断,那么忙碌拥有中断回调的对象的属性确定是否丢弃或放入队列中。这些是可能的值忙碌属性:

  • '队列'—在正在运行的回调执行完毕后,将中断的回调放入一个队列中等待处理。

  • “取消”—不执行中断回呼。

此属性是只读的。

删除状态,返回类型类型的开/关逻辑值matlab.lang.OnOffSwitchState

Matlab设置了呈扭曲财产'上'DeleteFcn回调开始执行。这呈扭曲财产仍然存在'上'直到组件对象不再存在。

检查的值呈扭曲属性验证在查询或修改之前未删除对象是否即将删除。

父母/孩子

全部展开

父容器,指定为a数字对象创建的Uifigure.函数或它的一个子容器:选项卡面板ButtonGroup, 或者GridLayout.如果没有指定容器,Matlab会调用Uifigure.创建新的功能数字作为父容器的对象。

ButtonGroup儿女,归为空图表持有者或1-D阵列组件对象。一个孩子ButtonGroup对象可以是任何UI组件对象,包括另一个组件对象ButtonGroup目的。

控件添加或删除子组件孩子们财产的ButtonGroup.使用孩子们属性值查看子列表或重新排序子项。属性值阵列中子项的顺序反映了屏幕上组件的前后订单(堆叠顺序)。

要将子添加到此列表,请设置父母子组件的财产ButtonGroup

指定的对象句柄的可见性'上''打回来', 或者“关闭”

此属性控制其父母的子项列表中对象的可见性。当对象在其父子节目列表中不可见时,它不会通过搜索对象层次结构或查询属性来获取对象的函数返回。这些功能包括得到findobjCLF.,关闭.即使它们不可见,对象也有效。如果可以访问对象,则可以设置和获取其属性,并将其传递给对象上运行的任何功能。

HandleVisibility价值 描述
'上' 该对象始终可见。
'打回来' 该对象在回调函数或由回调函数调用的函数中可见,但在从命令行调用的函数中不可见。这个选项阻止在命令行访问该对象,但允许回调函数访问它。
“关闭” 对象始终是不可见的。此选项对于防止其他函数对UI的意外更改非常有用。设定Huppervisibility.“关闭”在执行该函数期间临时隐藏对象。

身份标识

全部展开

此属性是只读的。

图形对象类型,返回为'UIBUTTONGROUP'

对象标识符,指定为字符向量或字符串标量。您可以指定唯一的标签作为对象的标识符的值。当您需要访问代码中其他地方的对象时,可以使用findobj基于的功能搜索对象标签价值。

用户数据,指定为任何MATLAB阵列。例如,您可以指定标量,向量,矩阵,单元格数组,字符数组,表或结构。使用此属性在对象上存储任意数据。

如果您在App Designer中工作,请在应用程序中创建公共或私有属性以共享数据而不是使用用户数据财产。有关更多信息,请参阅在应用设计者应用中分享数据

也可以看看

职能

在R2016A介绍