uitab
创建选项卡式面板
说明
t = uitab
在选项卡组内创建一个选项卡,并返回 Tab
对象。如果没有可用的选项卡组,MATLAB® 将调用 figure
函数以创建一个图窗。然后,它在该图窗中创建一个选项卡组,并将选项卡放在该选项卡组内。
t = uitab(___,
创建一个选项卡,其属性由一个或多个名称-值参量指定。例如,使用 Name,Value
)Title
属性指定选项卡标题。可将此选项与上述语法中的任何输入参量组合一起使用。
示例
创建选项卡
在 UI 图窗中创建一个具有两个选项卡的选项卡组。指定每个选项卡的标题。
fig = uifigure; tg = uitabgroup(fig); t1 = uitab(tg,"Title","Data"); t2 = uitab(tg,"Title","Plots");
设置和访问选项卡属性值
在 UI 图窗中创建一个具有两个选项卡的选项卡组,并通过指定属性值来自定义选项卡的外观。
fig = uifigure; tg = uitabgroup(fig); t1 = uitab(tg,"Title","Data","BackgroundColor",[0 0.4470 0.7410]); t2 = uitab(tg,"Title","Plots","BackgroundColor",[0 0.4470 0.7410]);
查询 Data 选项卡标题的文本颜色。
c = t1.ForegroundColor
c = 1×3
0 0 0
更新文本颜色以匹配选项卡背景颜色。
t1.ForegroundColor = t1.BackgroundColor;
创建可滚动选项卡
Scrollable
属性支持在选项卡内的组件超出边框时启用滚动。仅当父选项卡组位于使用 uifigure
函数创建的图窗中时,才可以滚动。App 设计工具使用此类型的图窗来创建 App。
创建包含一个选项卡的选项卡组。向该选项卡添加六个 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。
输入参数
名称-值参数
将可选的参量对组指定为 Name1=Value1,...,NameN=ValueN
,其中 Name
是参量名称,Value
是对应的值。名称-值参量必须出现在其他参量之后,但参量对组的顺序无关紧要。
示例: uitab(Title="Options")
指定选项卡标题为 Options
。
在 R2021a 之前,使用逗号分隔每个名称和值,并用引号将 Name
引起来。
示例: uitab("Title","Options")
指定选项卡标题为 Options
。
注意
此处所列的属性只是可用属性中的一部分。有关完整列表,请参阅 Tab 属性。
Title
— 标题
字符向量 | 字符串标量 | 分类数组
标题,指定为字符向量、字符串标量或分类数组。如果将此属性指定为分类数组,MATLAB 将仅显示数组中的第一个元素。
MATLAB 不会将竖线 ('|'
) 字符解释为换行符,它在标题中显示为竖线。
如果要指定 Unicode® 字符,则将 Unicode 十进制码传递到 char
函数。例如,['Multiples of ' char(960)]
显示为 Multiples of
π。
BackgroundColor
— 背景色
[0.94 0.94 0.94]
(默认) | RGB 三元组 | 十六进制颜色代码 | 'r'
| 'g'
| 'b'
| ...
背景颜色,指定为 RGB 三元组、十六进制颜色代码或下表中列出的颜色选项之一。
RGB 三元组和十六进制颜色代码对于指定自定义颜色非常有用。
RGB 三元组是包含三个元素的行向量,其元素分别指定颜色中红、绿、蓝分量的强度。强度值必须位于
[0,1]
范围内,例如[0.4 0.6 0.7]
。十六进制颜色代码是字符向量或字符串标量,以井号 (
#
) 开头,后跟三个或六个十六进制数字,范围可以是0
到F
。这些值不区分大小写。因此,颜色代码"#FF8800"
与"#ff8800"
、"#F80"
与"#f80"
是等效的。
此外,还可以按名称指定一些常见的颜色。下表列出了命名颜色选项、等效 RGB 三元组和十六进制颜色代码。
颜色名称 | 短名称 | RGB 三元组 | 十六进制颜色代码 | 外观 |
---|---|---|---|---|
"red" | "r" | [1 0 0] | "#FF0000" | |
"green" | "g" | [0 1 0] | "#00FF00" | |
"blue" | "b" | [0 0 1] | "#0000FF" | |
"cyan" | "c" | [0 1 1] | "#00FFFF" | |
"magenta" | "m" | [1 0 1] | "#FF00FF" | |
"yellow" | "y" | [1 1 0] | "#FFFF00" | |
"black" | "k" | [0 0 0] | "#000000" | |
"white" | "w" | [1 1 1] | "#FFFFFF" |
以下是 MATLAB 在许多类型的绘图中使用的默认颜色的 RGB 三元组和十六进制颜色代码。
RGB 三元组 | 十六进制颜色代码 | 外观 |
---|---|---|
[0 0.4470 0.7410] | "#0072BD" | |
[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] | "#77AC30" | |
[0.3010 0.7450 0.9330] | "#4DBEEE" | |
[0.6350 0.0780 0.1840] | "#A2142F" |
Position
— 选项卡的位置和大小
[left bottom width height]
此 属性 为只读。
选项卡的位置和大小,返回为 [left bottom width height]
形式的四元素向量。此表介绍该向量中的每个元素。
元素 | 描述 |
---|---|
left | 选项卡组的内部左边缘与选项卡的内部左边缘之间的距离 |
bottom | 选项卡组的内部下边缘与选项卡的内部下边缘之间的距离 |
width | 选项卡的左右内部边缘之间的距离 |
height | 选项卡的上下内部边缘之间的距离 |
所有测量值都采用 Units
属性指定的单位。
注意
以下是使用 Position
属性时要注意的一些重要内容:
Position
值受到选项卡标题的长度和父TabGroup
对象的TabLocation
属性的影响。Position
值相对于父TabGroup
的可绘制区域,即边框内的区域。如果选项卡位于网格布局管理器中,则
Position
属性的值不会立即更新。要使用Position
值相对于选项卡大小调整选项卡子级的大小,请使用SizeChangedFcn
回调。
Units
— 测量单位
'pixels'
| 'normalized'
| 'inches'
| 'centimeters'
| 'points'
| 'characters'
测量单位,指定为下表中的值之一。
单位值 | 描述 |
---|---|
'pixels' (基于 uifigure 的 App 中的默认值) | 以像素为单位的距离不依赖 Windows® 和 Macintosh 系统上的系统分辨率:
在 Linux® 系统上,一个像素的大小由系统分辨率确定。 |
'normalized' (基于 figure 的 App 中的默认值) | 这些单位依据父容器进行归一化。容器的左下角映射到 |
'inches' | 英寸。 |
'centimeters' | 厘米。 |
'points' | 磅。1 磅等于 1/72 英寸。 |
'characters' | 这些单位基于图形根对象的默认 uicontrol 字体:
要访问默认的 uicontrol 字体,请使用 |
推荐值为 'pixels'
,因为大多数 MATLAB App 构建功能都以像素为单位测量距离。您可以创建一个对象,该对象根据父容器的大小重新缩放,方法是将使用 uigridlayout
函数创建的一个网格布局管理器作为该对象的父级。有关详细信息,请参阅Lay Out Apps Programmatically。
版本历史记录
在 R2014b 中推出
MATLAB 命令
您点击的链接对应于以下 MATLAB 命令:
请在 MATLAB 命令行窗口中直接输入以执行命令。Web 浏览器不支持 MATLAB 命令。
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)