TabGroup
选项卡组 UI 容器
说明
选项卡组 UI 容器在 App 中对选项卡进行分组和管理。在创建选项卡组后，使用 TabGroup 对象修改其外观和行为。
创建对象
使用 uitabgroup 函数在 App 中创建一个选项卡组。
属性
示例
创建一个图窗，其中包含一个选项卡组和两个选项卡。
f = figure; tabgp = uitabgroup(f,"Position",[.05 .05 .3 .8]); tab1 = uitab(tabgp,"Title","Settings"); tab2 = uitab(tabgp,"Title","Options");
获取当前选择的选项卡。
currenttab = tabgp.SelectedTab
currenttab =
Tab (Settings) with properties:
Title: 'Settings'
BackgroundColor: [0.9400 0.9400 0.9400]
Position: [0.0119 0.0089 0.9702 0.9107]
Units: 'normalized'
创建包含一个选项卡的选项卡组。向该选项卡添加六个 UI 组件，前三个组件位于选项卡的上边框的外部。
fig = uifigure; tg = uitabgroup(fig,"Position",[20 20 196 145]); t = uitab(tg,"Title","Member Information"); ef1 = uieditfield(t,"Text","Position",[11 165 140 22],"Value","First Name"); ef2 = uieditfield(t,"Text","Position",[11 140 140 22],"Value","Last Name"); ef3 = uieditfield(t,"Text","Position",[11 115 140 22],"Value","Address"); dd = uidropdown(t,"Position",[11 90 140 22],"Items",{'Male','Female'}); cb = uicheckbox(t,"Position",[11 65 140 22],"Text","Member"); b = uibutton(t,"Position",[11 40 140 22],"Text","Send");
通过将选项卡的 Scrollable 属性设置为 "on" 来启用滚动。默认情况下，滚动条显示在顶部。
t.Scrollable = "on";
在新脚本中，在 UI 图窗中创建一个具有两个选项卡的选项卡组。将 SelectionChangedFcn 属性指定为名为 displaySelection 的函数的句柄。当用户在选项卡组中的选项卡之间切换时，将执行此函数。
在脚本的底部，定义 displaySelection 函数来接受 MATLAB 传递给回调函数的两个输入参量：
src- 执行回调的组件event- 关于触发回调的用户交互的信息
在回调函数中，编写代码以在命令行窗口中显示可见选项卡的标题。
fig = uifigure; tg = uitabgroup(fig,"SelectionChangedFcn",@displaySelection); t1 = uitab(tg,"Title","Data"); t2 = uitab(tg,"Title","Plots"); function displaySelection(src,event) t = event.NewValue; title = t.Title; disp("Viewing the " + title + " tab") end
运行脚本并在选项卡之间切换以显示选项卡标题。
有关详细信息，请参阅Create Callbacks for Apps Created Programmatically。
版本历史记录
在 R2014b 中推出对于使用 figure 函数创建的 App，当您查询选项卡组的 InnerPosition 属性时，该属性将返回与上一版本不同的值。此外，如果 TabLocation 是 'left' 或 'bottom'，当您查询选项卡组中某个选项卡的 Position、InnerPosition 和 OuterPosition 属性时，这些属性可能会返回与以前版本不同值。这些更改使属性值和行为与基于 uifigure 的 App 中的属性一致。
下表描述 R2025a 及更早版本的属性值之间的差异。
| 属性 | 从 R2025a 开始 | R2024b 及更早版本 | ||
|---|---|---|---|---|
| 描述 | 图像 | 描述 | 图像 | |
选项卡组的 InnerPosition | 形式为 [left bottom width height] 的四元素向量，表示选项卡组相对于其父级的可绘制区域的大小和位置，不包括其中包含的选项卡的边框和标题 | 选项卡组
| 形式为 [left bottom width height] 的四元素向量，表示选项卡组相对于其父级的可绘制区域的大小和位置，包括其中所包含的选项卡的边框和标题 | 选项卡组
|
选项卡的 Position、InnerPosition 和 OuterPosition | 形式为 [left bottom width height] 的四元素向量，表示选项卡相对于选项卡组可绘制区域的大小和位置，其中选项卡组可绘制区域不包括边框和标题 | 相对于选项卡组可绘制区域（蓝色实线）的选项卡
| 形式为 [left bottom width height] 的四元素向量，表示选项卡相对于选项卡组可绘制区域的大小和位置，其中选项卡组可绘制区域包括边框和标题 | 相对于选项卡组可绘制区域（蓝色实线）的选项卡
|
如果您注意到 App 布局的变化，请考虑以下列方式更新您的代码：
选项卡组
InnerPosition- 用选项卡组Position属性替换对选项卡组InnerPosition属性的引用，以使用选项卡组的大小和位置，包括边框和选项卡标题。选项卡
Position、InnerPosition和OuterPosition- 替换对位置向量的前两个元素的引用，以使用选项卡标题在左侧或底部占据的空间。例如，如果您的 App 包含TabLocation值为'left'的选项卡组，并且您引用该选项卡组中某个选项卡的Position属性，请将该引用替换为选项卡组边框和选项卡可绘制区域之间的水平距离。
对于在 App 设计工具中创建并使用 uifigure 函数的 App，当您查询选项卡组的 InnerPosition 属性时，该属性将返回与以前版本不同值。此外，如果 TabLocation 是 'left' 或 'bottom'，当您查询选项卡组中某个选项卡的 Position、InnerPosition 和 OuterPosition 属性时，这些属性可能会返回与以前版本不同值。
下表描述 R2022b 及更早版本的属性值之间的差异。
| 属性 | 从 R2022b 开始 | R2022a 及更早版本 | ||
|---|---|---|---|---|
| 描述 | 图像 | 描述 | 图像 | |
选项卡组的 InnerPosition | 形式为 [left bottom width height] 的四元素向量，表示选项卡组相对于其父级的可绘制区域的大小和位置，不包括其中包含的选项卡的边框和标题 | 选项卡组
| 形式为 [left bottom width height] 的四元素向量，表示选项卡组相对于其父级的可绘制区域的大小和位置，包括其中所包含的选项卡的边框和标题 | 选项卡组
|
选项卡的 Position、InnerPosition 和 OuterPosition | 形式为 [left bottom width height] 的四元素向量，表示选项卡相对于选项卡组可绘制区域的大小和位置，其中选项卡组可绘制区域不包括边框和标题 | 相对于选项卡组可绘制区域（蓝色实线）的选项卡
| 形式为 [left bottom width height] 的四元素向量，表示选项卡相对于选项卡组可绘制区域的大小和位置，其中选项卡组可绘制区域包括边框和标题 | 相对于选项卡组可绘制区域（蓝色实线）的选项卡
|
如果您注意到 App 布局的变化，请考虑以下列方式更新您的代码：
选项卡组
InnerPosition- 用选项卡组Position属性替换对选项卡组InnerPosition属性的引用，以使用选项卡组的大小和位置，包括边框和选项卡标题。选项卡
Position、InnerPosition和OuterPosition- 替换对位置向量的前两个元素的引用，以使用选项卡标题在左侧或底部占据的空间。例如，如果您的 App 包含TabLocation值为'left'的选项卡组，并且您引用该选项卡组中某个选项卡的Position属性，请将该引用替换为选项卡组边框和选项卡可绘制区域之间的水平距离。
