Main Content

uipanel

创建面板容器

全页折叠

语法

p = uipanel
p = uipanel(parent)
p = uipanel(___,Name,Value)

说明

p = uipanel 在当前图窗中创建一个面板并返回 Panel 对象。如果没有可用的图窗，MATLAB® 将调用 figure 函数创建一个图窗。

p = uipanel(parent) 在指定的父容器中创建一个面板。父容器可以是使用 figure 或 uifigure 函数创建的图窗，也可以是子容器。

示例

p = uipanel(___,Name,Value) 使用一个或多个名称-值参量指定面板属性。可将此选项与上述语法中的任何输入参量组合一起使用。面板的属性值略有不同，具体取决于该 App 是使用 figure 还是 uifigure 函数创建的。

示例

示例

全部折叠

打开实时脚本

在 UI 图窗中创建一个面板。

fig = uifigure;
p = uipanel(fig);

Figure contains an object of type uipanel.

打开实时脚本

在 UI 图窗中创建一个面板，并在面板中添加一个按钮。

fig = uifigure;
p = uipanel(fig);
btn = uibutton(p);

Figure contains an object of type uipanel.

打开实时脚本

在 UI 图窗中创建一个面板，并通过指定属性值来自定义其外观。

fig = uifigure;
p = uipanel(fig, ...
    "Title","Data", ...
    "BackgroundColor","white");

Figure contains an object of type uipanel.

确定面板位置和大小。

s = p.Position
s = 1×4

    20    20   260   221

通过修改面板 Position 属性的第三个和第四个元素来更新面板的宽度和高度。

p.Position(3:4) = [150 380];

Figure contains an object of type uipanel.

Scrollable 属性支持在面板中的组件超出边框时启用滚动。仅当面板位于使用 uifigure 函数创建的图窗中时，才可以滚动。App 设计工具使用此类型的图窗来创建 App。

在 UI 图窗中创建一个面板。向该面板添加六个 UI 组件。前两个组件不可见，因为它们位于面板的上边框之外。

fig = uifigure;
p = uipanel(fig,"Position",[20 20 196 135]);
ef1 = uieditfield(p,"Text","Position",[11 165 140 22],"Value","First Name");
ef2 = uieditfield(p,"Text","Position",[11 140 140 22],"Value","Last Name");
ef3 = uieditfield(p,"Text","Position",[11 115 140 22],"Value","Address");
dd = uidropdown(p,"Position",[11 90 140 22],"Items",["Male","Female"]);
cb = uicheckbox(p,"Position",[11 65 140 22],"Text","Member");
btn = uibutton(p,"Position",[11 40 140 22],"Text","Send");

UI figure window with a panel with four UI components. Only one edit field is visible.

通过将 Scrollable 属性设置为 "on" 在面板中启用滚动功能。默认情况下，滚动条滚动到面板的顶部。

p.Scrollable = "on";

UI figure window with a scrollable panel. The panel has a scroll bar on its right. The bar is scrolled to the top, and all three edit fields are visible in the panel.

输入参数

全部折叠

父容器，指定为使用 figure 或 uifigure 函数创建的图窗或子容器：

  • 面板、选项卡和按钮组可以是任一类型的图窗中的容器。

  • 网格布局是只能位于使用 uifigure 函数创建的图窗中的容器。

名称-值参数

将可选的参量对组指定为 Name1=Value1,...,NameN=ValueN，其中 Name 是参量名称，Value 是对应的值。名称-值参量必须出现在其他参量之后，但参量对组的顺序无关紧要。

示例: uipanel(Title="Options") 指定面板标题为 Options。

在 R2021a 之前，使用逗号分隔每个名称和值，并用引号将 Name 引起来。

示例: uipanel("Title","Options") 指定面板标题为 Options。

注意

此处所列的属性只是可用属性中的一部分。有关完整列表，请参阅 Panel。

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

MATLAB 不会将竖线 ('|') 字符解释为换行符，它在标题中显示为竖线。

如果要指定 Unicode® 字符，则将 Unicode 十进制码传递到 char 函数。例如，['Multiples of ' char(960)] 显示为 Multiples of π。

背景颜色，指定为 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"

Sample of the color red

"green""g"[0 1 0]"#00FF00"

Sample of the color green

"blue""b"[0 0 1]"#0000FF"

Sample of the color blue

"cyan" "c"[0 1 1]"#00FFFF"

Sample of the color cyan

"magenta""m"[1 0 1]"#FF00FF"

Sample of the color magenta

"yellow""y"[1 1 0]"#FFFF00"

Sample of the color yellow

"black""k"[0 0 0]"#000000"

Sample of the color black

"white""w"[1 1 1]"#FFFFFF"

Sample of the color white

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

RGB 三元组十六进制颜色代码外观
[0 0.4470 0.7410]"#0072BD"

Sample of RGB triplet [0 0.4470 0.7410], which appears as dark blue

[0.8500 0.3250 0.0980]"#D95319"

Sample of RGB triplet [0.8500 0.3250 0.0980], which appears as dark orange

[0.9290 0.6940 0.1250]"#EDB120"

Sample of RGB triplet [0.9290 0.6940 0.1250], which appears as dark yellow

[0.4940 0.1840 0.5560]"#7E2F8E"

Sample of RGB triplet [0.4940 0.1840 0.5560], which appears as dark purple

[0.4660 0.6740 0.1880]"#77AC30"

Sample of RGB triplet [0.4660 0.6740 0.1880], which appears as medium green

[0.3010 0.7450 0.9330]"#4DBEEE"

Sample of RGB triplet [0.3010 0.7450 0.9330], which appears as light blue

[0.6350 0.0780 0.1840]"#A2142F"

Sample of RGB triplet [0.6350 0.0780 0.1840], which appears as dark red

面板的位置和大小，包括边框和标题，指定为 [left bottom width height] 形式的四元素向量。此表介绍该向量中的每个元素。

元素描述
left父容器的内部左边缘与面板的外部左边缘之间的距离
bottom父容器的内部下边缘与面板的外部下边缘之间的距离
width面板的左右外部边缘之间的距离
height面板的上下外部边缘之间的距离

所有测量值都采用 Units 属性指定的单位。

Position 值相对于父容器的可绘制区域。可绘制区域是指容器边框内的区域，不包括装饰元素（如菜单栏或标题）所占的区域。

注意

如果网格布局管理器是该面板的父级，则 Position 属性的值不会立即更新。要使用 Position 值相对于面板大小调整面板子级的大小，请使用 SizeChangedFcn 回调。

测量单位，指定为下表中的值之一。

单位值描述
'pixels'（基于 uifigure 的 App 中的默认值）

以像素为单位的距离不依赖 Windows® 和 Macintosh 系统上的系统分辨率：

  • 在 Windows 系统上，一个像素是 1/96 英寸。

  • 在 Macintosh 系统上，一个像素是 1/72 英寸。

在 Linux® 系统上，一个像素的大小由系统分辨率确定。

'normalized'（基于 figure 的 App 中的默认值）

这些单位依据父容器进行归一化。容器的左下角映射到 (0,0)，右上角映射到 (1,1)。

'inches'英寸。
'centimeters'厘米。
'points'磅。1 磅等于 1/72 英寸。
'characters'

这些单位基于图形根对象的默认 uicontrol 字体：

  • 字符宽度 = 字母 x 的宽度。

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

要访问默认的 uicontrol 字体，请使用 get(groot,'defaultuicontrolFontName') 或 set(groot,'defaultuicontrolFontName')。

推荐值为 'pixels'，因为大多数 MATLAB App 构建功能都以像素为单位测量距离。您可以创建一个对象，该对象根据父容器的大小重新缩放，方法是将使用 uigridlayout 函数创建的一个网格布局管理器作为该对象的父级。有关详细信息，请参阅Lay Out Apps Programmatically。

提示

如果将面板对象的 Visible 属性设置为 "off"，该对象包含的所有子对象（例如按钮、按钮组或坐标区）以及父面板都将不可见。但是，每个子对象的 Visible 属性值不受影响。

版本历史记录

在 R2006a 之前推出

全部展开

另请参阅

属性