本页对应的英文页面已更新,但尚未翻译。 若要查看最新内容,请点击此处访问英文页面。

uipanel

创建面板容器对象

说明

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

p = uipanel(Name,Value) 使用一个或多个名称-值对组参数指定面板属性值。

p = uipanel(parent) 在指定的父容器中创建面板。父容器可以是使用 figureuifigure 函数创建的图窗,也可以是子容器(如选项卡或网格布局)。uipanel 的属性值略有不同,具体取决于该 App 是使用 figure 还是 uifigure 函数创建的。有关详细信息,请参阅名称-值对组参数

示例

p = uipanel(parent,Name,Value) 指定父容器和一个或多个属性值。

示例

全部折叠

创建一个包含两个面板和一个普通按钮的图窗。这些面板使用默认 Units 属性值 'normalized'uicontrol 的默认单位是 'pixels'

h = figure;
hp = uipanel('Title','Main Panel','FontSize',12,...
             'BackgroundColor','white',...
             'Position',[.25 .1 .67 .67]);
hsp = uipanel('Parent',hp,'Title','Subpanel','FontSize',12,...
              'Position',[.4 .1 .5 .5]);
hbsp = uicontrol('Parent',hsp,'String','Push here',...
              'Position',[18 18 72 36]);

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

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

f = uifigure;
p = uipanel(f,'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','Addess');
dd = uidropdown(p,'Position',[11 90 140 22],'Items',{'Male','Female'});
cb = uicheckbox(p,'Position',[11 65 140 22],'Text','Member');
b = uibutton(p,'Position',[11 40 140 22],'Text','Send');

通过将面板的 Scrollable 属性设置为 'on' 来启用滚动。默认情况下,滚动框显示在顶部。

p.Scrollable = 'on';

输入参数

全部折叠

父容器,指定为使用 figureuifigure 函数创建的图窗或子容器:

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

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

名称-值对组参数

示例: 'Title','Options' 指定面板标题为 Options

指定可选的、以逗号分隔的 Name,Value 对组参数。Name 为参数名称,Value 为对应的值。Name 必须放在单引号 (' ') 中。您可以指定多个名称-值对组参数,如 Name1,Value1,...,NameN,ValueN

  • 有关适用于 GUIDE 或用于与 figure 函数一起创建 App 的可用属性列表,请参阅 GUIDE 的 Panel 属性

  • 有关适用于 App 设计工具或用于与 uifigure 函数一起创建 App 的可用属性列表,请参阅 App 设计工具的 Panel 属性

提示

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

另请参阅

属性

在 R2006a 之前推出