主要内容

TabGroup属性

控件选项卡组的外观和行为Uifigure.的应用程序

选项卡组是对选项卡进行分组和管理的容器。属性控制选项卡组的外观和行为。使用点符号来引用特定的对象和属性。

图= Uifigure;tg = uitabgroup(图);tg.position = [20 20 200 200];

在应用程序设计器中列出的属性对选项卡组有效,或者在使用Uifigure.函数。用于指南中使用的标签组,或使用数字功能,请参阅TabGroup属性

选项卡

全部展开

标签标签位置,指定为“高级”'底部'“左”, 或者“对”.此属性指定选项卡标签相对于选项卡组的位置。

当前选中的选项卡,指定为选项卡对象。使用此属性可确定选项卡组中当前选定的选项卡。您还可以使用此属性设置默认选项卡选择。的默认值selectentTab.属性是第一个选项卡你加到TabGroup

互动

全部展开

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

  • “上”- 显示对象。

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

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

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

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

工具提示,指定为字符向量、字符向量的单元格数组、字符串数组或分类数组。当用户在运行时将指针悬停在选项卡组上时,使用此属性显示消息。只有当选项卡组中没有选项卡时,选项卡组的工具提示才会显示。若要显示多行文本,请指定字符向量、字符串数组或类别数组的单元格数组。数组中的每个元素变成一行单独的文本。如果你指定这个属性为分类数组,MATLAB®使用数组中的值,而不是完整的类别。

上下文菜单,指定为上下文菜单使用uicontextmenu函数。右键单击组件时,请使用此属性显示上下文菜单。

位置

全部展开

选项卡组的位置和大小,指定为表单的四元素向量[左下角宽度高度]

该表描述了向量中的每个元素。

元素 描述
从父容器的左内边缘到选项卡组的左外边缘的距离
距离父容器的内底边缘到标签组的外底边缘的距离
宽度 选项卡组右侧和左侧外边缘之间的距离
高度 制表符组的上下外缘之间的距离

所有测量的单位均由单位财产。

位置值相对于可拉的区域父容器的。绘制区域是容器边界内的区域,不包括菜单栏或标题等装饰占据的区域。

选项卡组的位置和大小,指定为表单的四元素向量[左下角宽度高度].所有测量的单位均由单位财产。

该属性值与位置OuterPosition属性值。

选项卡组的位置和大小,指定为表单的四元素向量[左下角宽度高度].所有测量的单位均由单位财产。

该属性值与位置内在属性值。

计量单位,指定为“像素”

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

  • “上”- 当容器调整大小时,子组件会自动调整大小。

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

AutoResizeChildren属性影响容器的直接子容器,而不是嵌套容器中的子容器。

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

要禁用应用程序的大小,请设置调整这个数字的财产“关闭”

布局选项,指定为aGridLayoutOptions对象。此属性为网格布局容器的子组件指定选项。如果组件不是网格布局容器的子组件(例如,它是图形或面板的子组件),则此属性为空,不起作用。但是,如果组件是网格布局容器的子组件,则可以通过设置属性GridLayoutOptions对象。

例如,这段代码在其父网格的第三行和第二列中放置了一个选项卡组。

G = uigridlayout([4 3]);tg = uitabgroup (g);tg.Layout.Row = 3;tg.Layout.Column = 2;

要使选项卡组跨多行或多列,请指定或者属性为二元素向量。例如,这个选项卡组跨列2通过3.:

tg.Layout.Column = [2 3];

回调

全部展开

选择更改了回调,指定为其中一个值:

  • 功能手柄。

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

  • 包含有效MATLAB表达式的字符向量(不推荐)。MATLAB在基本工作空间中计算这个表达式。

当用户在选项卡组中选择不同的选项卡时,执行此回调函数。

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

控件的属性如下表所示SelectionChangedData对象。

财产

描述

OldValue

以前选择过选项卡, 或者[]如果没有选择

纽瓦伊

目前选择了选项卡

执行回调的组件

EventName

“选择”

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

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

  • 功能手柄。

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

  • 包含有效MATLAB表达式的字符向量(不推荐)。MATLAB在基本工作空间中计算这个表达式。

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

请注意

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

SizeChangedFcn回调执行时间:

  • 这个容器第一次变得可见。

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

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

定义a时需要考虑的其他要点SizeChangedFcn回调函数:

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

  • 如果你的应用程序包含嵌套容器,它们会从内到外调整大小。

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

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

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

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

按下回调函数,指定为以下值之一:

  • 功能手柄。

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

  • 包含有效MATLAB表达式的字符向量(不推荐)。MATLAB在基本工作空间中计算这个表达式。

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

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

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

  • 函数处理。

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

  • 字符矢量包含有效的matlab表达式(不推荐)。MATLAB在基本工作空间中计算这个表达式。

有关将回调作为函数句柄,小区阵列或字符向量的更多信息,请参阅在应用程序设计器中编写回调

此属性指定MATLAB创建对象时执行的回调函数。方法之前,MATLAB初始化所有属性值CreateFcn回调。如果不指定CreateFcn属性,然后MATLAB执行一个默认创建函数。

设置CreateFcn属性对现有组件没有影响。

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

对象删除函数,指定为以下值之一:

  • 函数处理。

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

  • 字符矢量包含有效的matlab表达式(不推荐)。MATLAB在基本工作空间中计算这个表达式。

有关将回调作为函数句柄,小区阵列或字符向量的更多信息,请参阅在应用程序设计器中编写回调

此属性指定当MATLAB删除对象时执行的回调函数。MATLAB执行DeleteFcn在销毁对象的属性之前回调。如果不指定DeleteFcn属性,然后MATLAB执行一个默认删除函数。

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

回调执行控制

全部展开

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

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

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

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

每当MATLAB调用回调时,该回调尝试中断正在运行的回调(如果存在的话)。的可中断属性决定是否允许中断。

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

    • 如果正在运行的回调函数包含其中一个命令,那么MATLAB将在此时停止回调函数的执行,并执行中断回调函数。当中断回调完成时,MATLAB继续执行正在运行的回调。

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

  • 的值“关闭”阻止所有中断尝试。的BusyAction拥有中断回调的对象的属性决定中断回调是否被丢弃或放入队列中。

请注意

在这些情况下,回调中断和执行情况不同:

  • 如果中断回调是一个DeleteFcnCloseRequestFcn或者SizeChangedFcn回调,则中断发生不管可中断适当的价值。

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

  • 计时器对象根据调度执行,而不管可中断适当的价值。

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

回调排队,指定为'队列'或者“取消”.的BusyAction属性决定了MATLAB如何处理中断回调的执行。有两种回调状态需要考虑:

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

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

当MATLAB调用回调时,回调试图中断正在运行的回调。的可中断属性决定是否允许中断。如果不允许中断,那么BusyAction拥有中断回调的对象的属性决定了它是被丢弃还是放入队列中。这些是可能的值BusyAction财产:

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

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

此属性是只读的。

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

MATLAB设置呈扭曲财产“上”DeleteFcn回调开始执行。的呈扭曲属性仍然设置为“上”直到组件对象不再存在。

检查价值呈扭曲属性来验证对象在查询或修改之前不会被删除。

父母/孩子

全部展开

父容器,指定为数字使用Uifigure.函数或其子容器之一:选项卡面板ButtonGroup, 或者GridLayout.如果没有指定容器,则MATLAB调用Uifigure.函数创建一个新的数字用作父容器的对象。

TabGroup儿女,归为空GraphicsPlaceholder或一维数组选项卡对象。

控件不能添加或删除选项卡孩子们财产的TabGroup.使用此属性查看选项卡列表或重新排序选项卡。的顺序选项卡这个数组中的对象反映了在屏幕上显示的选项卡的顺序。

要将子添加到此列表,请设置父母财产的选项卡对象是TabGroup对象。

对象句柄的可见性,指定为“上”“回调”, 或者“关闭”

此属性控制对象在其父的子列表中的可见性。当一个对象在其父的子列表中不可见时,通过搜索对象层次结构或查询属性获取对象的函数不会返回该对象。这些功能包括得到findobjclf,关闭.对象即使不可见也是有效的。如果你可以访问一个对象,你可以设置和获取它的属性,并将它传递给任何操作对象的函数。

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

标识符

全部展开

此属性是只读的。

图形对象的类型,返回为'uitabgroup'

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

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

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

另请参阅

功能

特性

介绍了R2016a