主要内容

uipanel

创建面板容器

折叠所有页面

语法

P = uipanel
p = uipanel(名称，值)
P = uipanel(parent)
p = uipanel(parent,Name,Value)

描述

P = uipanel控件在当前图中创建面板并返回面板对象。如果没有可用的图形，MATLAB®调用数字函数来创建一个。

P = uipanel(名称,值）使用一个或多个名称-值对参数指定面板属性值。

P = uipanel(父）在指定的父容器中创建面板。属性创建的图形可以是父容器数字或uifigure函数或子容器，如选项卡或网格布局。的属性值uipanel类型创建的应用程序略有不同数字或uifigure函数。有关更多信息，请参见名称-值对参数．

例子

P = uipanel(父，名称,值）指定父容器和一个或多个属性值。

例子

全部折叠

创建一个包含两个面板和一个按钮的图形。面板使用默认值单位属性值,“归一化”．的默认单位uicontrol是“像素”．

F =数字;P = uipanel(“标题”，主面板的，“字形大小”12.．.“写成BackgroundColor”，“白色”，.．.“位置”,(。25 .1 .67 .67]);Sp = uipanel(“父”、磷、“标题”，“子面板”，“字形大小”12.．.“位置”,(。4 .1 .5 .5]);C = uicontrol(“父”sp,“字符串”，“把这里”，.．.“位置”，[18 18 72 36]);

应用程序有两个面板和一个按钮。主面板包含嵌套在其中的灰色子面板。按钮位于子面板内。

的可滚动属性允许在边框外有组件的面板内滚动。控件创建的图形中才可以滚动面板uifigure函数。App Designer使用这种类型的图形来创建应用程序。

在图中创建一个面板。向面板添加六个UI组件，前三个位于面板的上边框之外。

FIG = ufigure;P = uipanel(图，“位置”，[20 20 196 135]);Ef1 = uieditfield(p，“文本”，“位置”，[11 165 140 22]，“价值”，“名字”）;Ef2 = uieditfield(p，“文本”，“位置”，[11 140 140 22]，“价值”，“姓”）;Ef3 = uieditfield(p，“文本”，“位置”，[11 115 140 22]，“价值”，“地址”）;Dd = uidropdown(p，“位置”，[11 90 140 22]，“项目”, {“男”，“女”}）;Cb = uicheckbox(p，“位置”，[11 65 140 22]，“文本”，“成员”）;BTN = uibutton(p，“位置”，[11 40 140 22]，“文本”，“发送”）;

一个包含有许多UI组件的面板的应用程序。两个编辑字段和第三个字段的一半不可见。

属性启用滚动可滚动属性设置为“上”．默认情况下，滚动框显示在顶部。

p.Scrollable =“上”；

一个包含可滚动面板的应用程序。面板右侧有一个滚动条。该工具条被滚动到顶部，所有三个编辑字段都在面板中可见。

输入参数

全部折叠

属性创建的图形指定为父容器数字或uifigure函数或子容器:

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

  • 控件创建的图形中的网格布局只能是容器uifigure函数。

名称-值参数

指定可选参数对为Name1 = Value1,…,以=家,在那里的名字参数名称和价值对应的值。名称-值参数必须出现在其他参数之后，但对的顺序无关紧要。

例子:uipanel (Title =“选项”)指定面板标题为选项．

在R2021a之前，使用逗号分隔每个名称和值，并将其括起来的名字在报价。

例子:uipanel(“标题”、“选项”)指定面板标题为选项．

请注意

这里列出的属性是可用属性的子集。有关完整列表，请参见面板属性．

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

MATLAB不解释垂直斜杠(“|”)字符作为换行符，则在标题中显示为垂直斜杠。

如果您想指定一个Unicode®字符，将Unicode十进制代码传递给字符函数。例如,['Multiples of ' char(960)]显示为的倍数π．

背景色，指定为RGB三元组、十六进制颜色代码或表中列出的颜色选项之一。

RGB三组和十六进制颜色代码对于指定自定义颜色很有用。

  • RGB三元组是一个三元素行向量，其元素指定颜色的红、绿和蓝分量的强度。强度必须在这个范围内[0, 1]；例如,[0.4 0.6 0.7]．

  • 十六进制颜色码是字符向量或以散列符号(＃)后面跟着三个或六个十六进制数字，取值范围为0来F．这些值不区分大小写。因此，颜色代码“# FF8800”，“# ff8800”，“# F80”,“# f80”是等价的。

或者，您可以通过名称指定一些常用颜色。该表列出了已命名的颜色选项、等效的RGB三元组和十六进制颜色代码。

颜色名称 短名称 RGB值 十六进制颜色代码 外观
“红色” “r” [10 0 0] “# FF0000”

样品的颜色为红色
“绿色” “g” [0 10 0] “# 00 ff00”

样品的颜色为绿色
“蓝色” “b” [0 0 1] “# 0000 ff”

样品的颜色为蓝色
“青色” “c” [0 1 1] “# 00飞行符”

样品的颜色为青色
“红色” “m” [10 0 1] “#”就

样品的颜色为洋红色
“黄色” “y” [11 10 0] “# FFFF00”

样品的颜色为黄色
“黑色” “k” [0 0 0] “000000 #”

样品颜色为黑色
“白色” “w” [1 1 1] “# FFFFFF”

样品颜色为白色

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

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

RGB三联体[0 0.4470 0.7410]样品，呈深蓝色
[0.8500 0.3250 0.0980] “# D95319”

RGB三联体样品[0.8500 0.3250 0.0980]，呈暗橙色
[0.9290 0.6940 0.1250] “# EDB120”

RGB三联体样品[0.9290 0.6940 0.1250]，呈暗黄色
[0.4940 0.1840 0.5560] “# 7 e2f8e”

RGB三联体样品[0.4940 0.1840 0.5560]，呈深紫色
[0.4660 0.6740 0.1880] “# 77 ac30”

RGB三联体[0.4660 0.6740 0.1880]样本，呈现中绿色
[0.3010 0.7450 0.9330] “# 4 dbeee”

RGB三联体样品[0.3010 0.7450 0.9330]，呈浅蓝色
[0.6350 0.0780 0.1840] “# A2142F”

RGB三联体样品[0.6350 0.0780 0.1840]，呈暗红色

面板的位置和大小，包括边框和标题，指定为窗体的四元素向量[左下宽高]．该表描述了向量中的每个元素。

元素 描述
左 从父容器的左内边缘到面板的左外边缘的距离
底 从父容器的内底边到面板的外底边的距离
宽度 面板左右外缘之间的距离
高度 面板上下外缘之间的距离

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

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

请注意

的值。如果面板父元素为网格布局管理器位置属性不会立即更新。使用位置值来根据面板大小调整子面板的大小，请使用SizeChangedFcn回调。

度量单位，在本表中指定为其中一个值。

单位价值 描述
“像素”(默认在uifigure的应用程序)

在Windows上，以像素为单位的距离与系统分辨率无关®而且麦金塔电脑系统:

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

  • 在麦金塔电脑在系统中，一个像素是1/72英寸。

在Linux上®在系统中，像素的大小是由系统分辨率决定的。
“归一化”(默认在数字的应用程序)

这些单元相对于父容器是规范化的。容器的左下角映射到(0,0)右上角映射到(1,1)．
“英寸” 英寸。
“厘米” 厘米。
“点” 点。1分等于1/72英寸。
“角色”

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

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

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

要访问默认的uicontrol字体，请使用get(大的,“defaultuicontrolFontName”)或集(大的,“defaultuicontrolFontName”)．

推荐值为:“像素”，因为大多数MATLAB应用程序构建功能以像素为单位测量距离。类创建的网格布局管理器的父对象中，可以创建一个根据父容器大小重新缩放的对象uigridlayout函数。有关更多信息，请参见以编程方式布局应用程序．

提示

如果你设置可见属性“关闭”，那么它所包含的任何子对象(按钮、按钮组、轴等)将随着父面板一起变得不可见。然而,可见属性值每个子对象都不受影响。

版本历史

R2006a之前介绍

全部展开

另请参阅

属性