在 GUIDE 布局区域中添加组件
注意
在以后的版本中将会删除 GUIDE 环境。在删除 GUIDE 后,使用 GUIDE 创建的现有 App 可以继续在 MATLAB® 中运行,但不能在 GUIDE 中对其进行编辑。
要继续编辑使用 GUIDE 创建的现有 App,请参阅 GUIDE 迁移策略,了解有关如何帮助保持该 App 与未来 MATLAB 版本的兼容性的信息。要以交互方式创建新 App,请改用使用 App 设计工具开发 App。
放置组件
布局编辑器左侧的组件选项板包含可以添加到 UI 的组件。
要将组件放置在 GUIDE 布局区域并为每个组件提供唯一标识符,请执行以下步骤:
在选项板上显示组件名称。
在 MATLAB 的主页选项卡上的环境部分中,点击预设。
在“预设项”对话框中,点击 GUIDE。
选择在组件选项板中显示名称,然后点击确定。
根据您的设计在布局区域中放置组件。
将组件从选项板拖放到布局区域中。
在选项板中点击组件,并将光标移至布局区域上方。光标变为十字形。再次点击以其默认大小添加组件,或在添加组件时点击并拖动以调整组件大小。
在布局区域中定义 UI 组件后,选择该组件会自动在属性检查器中显示它。如果属性检查器未打开或不可见,双击某个组件会打开检查器并将焦点置于该组件上。
下表中列出的组件有其他注意事项;请在表中所述的章节中阅读有关组件的更多内容。
如果要添加.... 则... 面板或按钮组 请参阅向面板或按钮组添加组件。 菜单 请参阅为使用 GUIDE 创建的 App 创建菜单 为每个组件分配一个唯一标识符。请通过设置组件的
Tag
属性的值来完成此操作。有关详细信息,请参阅 为每个组件分配标识符。通过设置适当的属性来指定每个组件的外观。以下主题包含特定信息。
这是布局编辑器中的 UI 示例。布局编辑器中的组件未处于活动状态。
使用坐标放置组件
GUIDE 布局编辑器底部的状态栏显示:
当前点 - 鼠标相对于布局编辑器中网格区域左下角的当前位置。
位置 - 所选组件的
Position
属性是向量:[与左侧的距离, 与底部的距离, 宽度, 高度],其中距离是相对于父图窗、面板或按钮组而言的。
下面是对状态栏和标尺中坐标的解释:
位置值会随着您移动组件和调整组件大小而更新。向量的前两个元素会随着您移动组件而发生变化。向量的后两个元素随着组件高度和宽度的变化而变化。
如果未选择任何组件,位置值会显示图窗的位置和大小。
向面板或按钮组添加组件
要向面板或按钮组添加组件,请在组件选项板中选择该组件,然后将光标移至目标面板或按钮组上方。光标的位置决定组件的父项。
GUIDE 会突出显示可能的父项,如下图所示。突出显示表示如果您放下组件或点击光标,该组件将成为突出显示的面板、按钮组或图窗的子组件。
通过设置面板或按钮组中每个组件的 Tag
属性值,为其分配唯一标识符。有关详细信息,请参阅 为每个组件分配标识符。
在面板和按钮组中包含现有组件. 当您在面板或按钮组中添加新组件或将某个现有组件拖放至其中时,该组件将自动成为该面板或按钮组的成员或子组件,无论是被面板或按钮组完全包围还是部分包围。但是,如果该组件没有完全包含在面板或按钮组中,它会在布局编辑器和运行的 App 中显示为被裁剪。
您可以向 UI 添加新面板或按钮组,以便对其任何现有控件进行分组。要在新面板或按钮组中包含此类控件,请执行以下操作。这些操作说明是针对面板而言的,但也适用于按钮组内的组件。
选择“新建面板”或“新建按钮组”工具并拖动鼠标绘制一个矩形,使其具有所需的大小和位置。
面板不会遮盖其边界内的任何控件,除非它们是坐标区、表或其他面板或按钮组。请仅重叠您要嵌套的面板,然后确保完全重叠。
如果您的布局有此问题,您可以使用布局菜单上的下移一层或置于底层将新面板放置在您不想遮盖的组件后面。当您向面板添加组件或将组件拖到面板中时,面板会自动置于组件后面。
最好在此时使用属性检查器将面板的
Tag
和String
属性设置为所需的属性。从视图菜单打开对象浏览器,找到您刚才添加的面板。使用此工具验证它是否包含要组合在一起的所有控件。如果缺失任何组件,请执行以下步骤。
将您要包含但不适合放在面板内的控件拖到所需的位置。还要稍微移动已处于正确位置的控件,以将它们与面板组合在一起。
移动控件时,面板会突出显示,表示它现在包含该控件。对象浏览器会更新以确认关系。如果现在移动面板,其子控件也会随之移动。
提示
您需要用鼠标移动控件,才能将它们注册到周围的面板或按钮组中,即使只移动一两个像素。选择控件并使用箭头键来移动它们不能实现注册。使用对象浏览器验证控件是否正确嵌套。
有关如何将面板和按钮组合并到一个 UI 中的详细信息,请参阅面板和按钮组。
为每个组件分配标识符
使用 Tag
属性为您的组件分配唯一且有意义的标识符。
在布局区域内放置组件时,GUIDE 会为 Tag
属性分配默认值。在保存 UI 之前,用反映组件在 UI 中的角色的名称或缩写来替换该值。
代码使用您指定的名称来标识组件,该名称在 UI 中必须唯一。要设置 Tag
属性,请执行以下操作:
选择视图 > 属性检查器,或点击属性检查器按钮 。
在布局区域中,选择要为其设置
Tag
的组件。在属性检查器中,选择标记,然后用要用作标识符的名称替换该值。在下图中,
Tag
设置为pushbutton1
。
用户界面控件
用户界面控件包括普通按钮、切换按钮、滑块、单选按钮、编辑文本控件、静态文本控件、弹出式菜单、复选框和列表框。
要定义用户界面控件,必须设置某些属性。要完成此操作,请执行以下步骤:
使用属性检查器修改相应的属性。通过选择视图 > 属性检查器或点击属性检查器按钮 ,打开属性检查器。
在布局区域中,选择要定义的组件。
后续主题描述用户界面控件的常用属性,并为每种控件提供一个简单示例:
常用属性
下表显示了描述用户界面控件所需的最常用属性。特定控件的说明还可能列出了特定于该控件的属性。
属性 | 值 | 描述 |
---|---|---|
Enable | on , inactive , off .默认值是 on 。 | 确定控件是否可供用户使用 |
Max | 标量。默认值是 1。 | 最大值。具体解释取决于组件的类型。 |
Min | 标量。默认值是 0。 | 最小值。具体解释取决于组件的类型。 |
Position | 4 元素向量:[与左侧的距离, 与底部的距离, 宽度, 高度]。 | 组件的大小及相对于其父组件的位置。 |
String | 字符向量(例如,'button1' )。也可以是字符数组或字符向量元胞数组。 | 组件标签。对于列表框和弹出式菜单,它是项目列表。 |
Units | characters , centimeters , inches , normalized , pixels , points .默认值是 characters 。 | 用于解释 Position 属性向量的测量单位 |
Value | 标量或向量 | 组件的值。具体解释取决于组件的类型。 |
有关完整的属性列表以及表中所列属性的详细信息,请参阅 UIControl 属性。
普通按钮
要创建标签为 Button 1 的普通按钮,如下图所示,请执行以下操作:
通过将
String
属性设置为所需标签来指定普通按钮标签,在本例中为Button 1
。要在标签中显示 & 字符,请使用两个
&
字符。remove
、default
和factory
(区分大小写)为保留词语。要将上述词语之一用作标签,请在词语前面加一个反斜杠字符 (\
)。例如,输入\remove
将得到 remove。普通按钮只能容纳一行文本。如果指定多行,则只显示第一行。如果您创建的普通按钮太窄,无法容纳指定的
String
属性值,则 MATLAB 会用省略号截断该值。如果要将组件的位置或大小设置为精确值,请修改其
Position
属性。要向普通按钮添加图像,请将该按钮的
CData
属性指定为由定义真彩色图像的 RGB 值组成的 m×n×3 数组。您必须在代码文件的打开函数中以编程方式实现这一点。例如,数组img
使用介于 0 和 1 之间的随机值(由rand
生成)定义一个 16×64×3 真彩色图像。img = rand(16,64,3); set(handles.pushbutton1,'CData',img);
其中
pushbutton1
是普通按钮的Tag
属性。有关将矩阵
X
和对应的颜色图(即(X, MAP)
图像)转换为 RGB(真彩色)格式的信息,请参阅ind2rgb
。
滑块
要创建如下图所示的滑块,请执行以下操作:
通过将滑块的
Min
属性设置为其最小值,将其Max
属性设置为最大值,来指定滑块的范围。Min
属性值必须小于Max
属性值。通过将
Value
属性设置为适当的数值,指定创建滑块时滑块指示的值。此数值必须小于或等于Max
值且大于或等于Min
值。如果您指定的Value
在指定范围之外,则不会显示滑块。当用户点击箭头按钮时,滑块
Value
变化较小,而当用户点击滑块槽(也称为滑道)时,滑块变化较大。通过设置SliderStep
属性来控制滑块如何响应这些操作。将SliderStep
指定为二元素向量[minor_step major_step]
,其中minor_step
小于或等于major_step
。由于指定非常小的值会导致不可预测的滑块行为,请使minor_step
和major_step
都大于1e-6
。将major_step
设置为点击滑块槽时滑块移动范围的比例。将它设置为1
或更高的值,会导致在点击滑块槽时滑块移至Max
或Min
位置。随着
major_step
的增大,滑块会变长。当major_step
为 1 时,滑块的长度是滑块槽的一半。当major_step
大于 1 时,滑块长度会继续增加,慢慢接近滑块槽的全长。当滑块用作滚动条时,您可以通过更改major_step
的值来使用此行为指示文档当前有多少内容可见。如果要将组件的位置或大小设置为精确值,请修改其
Position
属性。滑块组件不提供文本说明或数据输入功能。使用静态文本组件对滑块加标签。使用编辑文本组件使用户能够输入应用于滑块的值。
在 Mac 平台上,水平滑块的高度受到限制。如果您在位置向量中设置的高度超过此限制,则显示的滑块高度是允许的最大值。位置向量的高度元素不变。
单选按钮
要创建下图所示的标签为 Indent nested functions 的单选按钮,请执行以下操作:
通过将
String
属性设置为所需的标签来指定单选按钮标签,在本例中为Indent nested functions
。要在标签中显示 & 字符,请使用两个
&
字符。remove
、default
和factory
(区分大小写)为保留词语。要将上述词语之一用作标签,请在词语前面加一个反斜杠字符 (\
)。例如,输入\remove
将得到 remove。单选按钮只能容纳一行文本。如果指定多行,则只显示第一行。如果您创建的单选按钮太窄,无法容纳指定的
String
属性值,MATLAB 软件会用省略号截断该值。通过将单选按钮的
Value
属性设置为其Max
属性的值(默认值为1
)来创建处于选中状态的单选按钮。将Value
设置为Min
(默认值为0
)可使单选按钮保持未选中状态。相应地,当用户选中单选按钮时,软件将Value
设置为Max
,当用户取消选中它时,软件将其设置为Min
。如果要将组件的位置或大小设置为精确值,请修改其
Position
属性。要向单选按钮添加图像,请将该按钮的
CData
属性指定为由定义真彩色图像的 RGB 值组成的 m×n×3 数组。您必须在代码文件的打开函数中以编程方式实现这一点。例如,数组img
使用介于 0 和 1 之间的随机值(由rand
生成)定义一个 16×24×3 真彩色图像。img = rand(16,24,3); set(handles.radiobutton1,'CData',img);
要管理单选按钮和切换按钮的互斥选择,请将它们放在一个按钮组中。有关详细信息,请参阅 按钮组。
复选框
要创建标签为 Display file extension 且最初处于选中状态的复选框,如下图所示,请执行以下操作:
通过将
String
属性设置为所需的标签来指定复选框标签,在本例中为Display file extension
。要在标签中显示 & 字符,请使用两个
&
字符。remove
、default
和factory
(区分大小写)为保留词语。要将上述词语之一用作标签,请在词语前面加一个反斜杠字符 (\
)。例如,输入\remove
将得到 remove。复选框只能容纳一行文本。如果指定的组件宽度太小,无法容纳指定的
String
属性值,MATLAB 软件会用省略号截断该值。通过将
Value
属性设置为Max
属性的值(默认值为1
)来创建处于选中状态的复选框。将Value
设置为Min
(默认值为0
)可使复选框保持未选中状态。相应地,当用户点击复选框时,软件会在用户选中复选框时将Value
设置为Max
,在用户清除复选框时将其设置为Min
。如果要将组件的位置或大小设置为精确值,请修改其
Position
属性。
编辑文本
要创建显示初始文本 Enter your name here 的编辑文本组件,如下图所示,请执行以下操作:
通过将
String
属性设置为所需的值,指定创建编辑文本组件时要显示的文本,在本例中为Enter your name here
。要在标签中显示 & 字符,请使用两个
&
字符。remove
、default
和factory
(区分大小写)为保留词语。要将上述词语之一用作标签,请在词语前面加一个反斜杠字符 (\
)。例如,输入\remove
将得到 remove。要启用多行输入,请指定
Max
和Min
属性并使其差值大于1
。例如,Max = 2
,Min = 0
。Max
的默认值为1
,Min
的默认值为0
。MATLAB 软件会对显示的文本换行,并在必要时添加滚动条。在所有平台上,当用户通过 Tab 键进入多行文本框时,编辑光标会放在先前的位置且不突出显示任何文本。如果
Max-Min
小于或等于 1,则编辑文本组件仅允许单行输入。如果指定的组件宽度太小,无法容纳指定的文本,则 MATLAB 仅显示该文本的一部分。用户可以使用箭头键在文本中移动光标。在所有平台上,当用户通过 Tab 键进入单行文本框时,整个内容会突出显示,编辑光标位于文本的末尾。如果要将组件的位置或大小设置为精确值,请修改其
Position
属性。通过在属性检查器的
FontName
条目中键入系统中存在的字体名称,可以指定要在编辑框中显示的文本字体。在 Microsoft® Windows® 平台上,默认值为MS Sans Serif
;在 Macintosh 和 UNIX® 平台上,默认值为Helvetica
。提示
要了解可用的字体,请在 MATLAB 提示符下键入
uisetfont
;将显示一个对话框,其中包含一个您可以从中选择和预览可用字体的列表框。当您选择一种字体时,其名称和其他特性会以结构体形式返回,您可以从中复制FontName
并将其粘贴到属性检查器中。并非所有列出的字体都可以在其他系统上使用。
静态文本
要创建文本为 Select a data set 的静态文本组件,如下图所示,请执行以下操作:
通过将组件的
String
属性设置为所需的文本来指定组件中出现的文本,在本例中为Select a data set
。要在列表项中显示 & 字符,请使用两个
&
字符。remove
、default
和factory
(区分大小写)为保留词语。要将上述词语之一用作标签,请在词语前面加一个反斜杠字符 (\
)。例如,输入\remove
将得到 remove。如果您的组件不够宽,无法容纳指定的值,MATLAB 会将显示的文本换行。
如果要将组件的位置或大小设置为精确值,请修改其
Position
属性。您可以指定文本字体,包括其
FontName
、FontWeight
、FontAngle
、FontSize
和FontUnits
属性。有关详细信息,请参阅上一主题编辑文本。
弹出式菜单
要创建包含 one、two、three 和 four 项的弹出式菜单(也称为下拉菜单或组合框),如下图所示,请执行以下操作:
通过将
String
属性设置为所需项,指定要显示的弹出式菜单项。点击属性名称右侧的按钮以打开属性检查器编辑器。
要在菜单项中显示 & 字符,请使用两个
&
字符。remove
、default
和factory
(区分大小写)为保留词语。要将上述词语之一用作标签,请在词语前面加一个反斜杠字符 (\
)。例如,输入\remove
将得到 remove。如果组件的宽度太小,无法容纳一个或多个菜单项,MATLAB 会用省略号截断这些项。
要在创建组件时选择一个项,请将
Value
设置为指示所选列表项索引的标量,其中 1 对应于列表中的第一项。如果您将Value
设置为2
,则创建的菜单如下所示:如果要将组件的位置和大小设置为精确值,请修改其
Position
属性。弹出式菜单的高度由字体大小决定。您在位置向量中设置的高度将被忽略。弹出式菜单不允许您添加标签。请使用静态文本组件为弹出式菜单添加标签。
列表框
要创建包含 one、two、three 和 four 项的列表框,如下图所示,请执行以下操作:
通过将
String
属性设置为所需列表,指定要显示的项目列表。请使用属性检查器编辑器输入列表内容。您可以通过点击属性名称右侧的 按钮来打开编辑器。要在标签中显示 & 字符,请使用两个
&
字符。remove
、default
和factory
(区分大小写)为保留词语。要将上述词语之一用作标签,请在词语前面加一个反斜杠字符 (\
)。例如,输入\remove
将得到 remove。如果组件的宽度太小,无法容纳一个或多个指定的列表项,MATLAB 软件会用省略号截断这些项。
使用
Value
属性以及Max
和Min
属性指定选择。要在创建组件时选择一个项,请将
Value
设置为指示所选列表项索引的标量,其中 1 对应于列表中的第一项。要在创建组件时选择多个项,请将
Value
设置为所选项的索引向量。Value = [1,3]
会产生如下选择。要支持选择多个项,您必须指定
Max
和Min
属性并使其差值大于1
。例如,Max = 2
,Min = 0
。Max
的默认值为1
,Min
的默认值为0
。如果不需要初始选择,请将
Max
和Min
属性设置为支持多重选择,即Max - Min > 1
,然后将Value
属性设置为空矩阵[]
。
如果列表框不够大,无法显示所有列表条目,您可以将
ListBoxTop
属性设置为您要在创建组件时显示在顶部的项的索引。如果要将组件的位置或大小设置为精确值,请修改其
Position
属性。列表框不提供标签。请使用静态文本组件对列表框加标签。
切换按钮
要创建标签为 Left/Right Tile 的切换按钮,如下图所示,请执行以下操作:
通过将切换按钮的
String
属性设置为所需的标签来指定切换按钮标签,在本例中为Left/Right Tile
。要在标签中显示 & 字符,请使用两个
&
字符。remove
、default
和factory
(区分大小写)为保留词语。要将上述词语之一用作标签,请在词语前面加一个反斜杠字符 (\
)。例如,输入\remove
将得到 remove。切换按钮只能容纳一行文本。如果指定多行,则只显示第一行。如果您创建的切换按钮太窄,无法容纳指定的
String
值,则 MATLAB 会用省略号截断文本。通过将切换按钮的
Value
属性设置为其Max
属性的值(默认值为1
),创建处于选中(按下)状态的切换按钮。将Value
设置为Min
(默认值为0
)可使切换按钮保持未选中(弹起)状态。相应地,当用户选中切换按钮时,MATLAB 软件将Value
设置为Max
,当用户取消选中它时设置为Min
。下图显示处于按下位置的切换按钮。如果要将组件的位置或大小设置为精确值,请修改其
Position
属性。要向切换按钮添加图像,请将该按钮的
CData
属性指定为由定义真彩色图像的 RGB 值组成的 m×n×3 数组。您必须在代码文件的打开函数中以编程方式实现这一点。例如,数组img
使用介于 0 和 1 之间的随机值(由rand
生成)定义一个 16×64×3 真彩色图像。img = rand(16,64,3); set(handles.togglebutton1,'CData',img);
其中
togglebutton1
是切换按钮的Tag
属性。要管理单选按钮和切换按钮的互斥选择,请将它们放在一个按钮组中。有关详细信息,请参阅 ButtonGroup 属性。
面板和按钮组
面板和按钮组是将 UI 组件排列成组的容器。如果您移动面板或按钮组,其子对象也会随之移动,并保持它们相对于面板或按钮组的位置。
要定义面板和按钮组,必须设置一些属性。要完成此操作,请执行以下步骤:
使用属性检查器修改相应的属性。通过选择视图 > 属性检查器或点击属性检查器按钮 ,打开属性检查器。
在布局区域中,选择要定义的组件。
后续主题说明面板和按钮组的常用属性,并为每个组件提供一个简单示例。
常用属性
下表显示了描述面板或按钮组所需的最常用属性:
属性 | 值 | 描述 |
---|---|---|
Position | 4 元素向量:[与左侧的距离, 与底部的距离, 宽度, 高度]。 | 组件的大小及相对于其父组件的位置。 |
Title | 字符向量(例如, | 组件标签。 |
TitlePosition |
| 标题相对于面板或按钮组的位置。 |
Units |
| 用于解释 |
有关完整的属性列表以及表中所列属性的详细信息,请参阅 Panel 属性 和 ButtonGroup 属性。
面板
要创建标题为 My Panel 的面板,如下图所示,请执行以下操作:
通过将
Title
属性设置为所需的值来指定面板标题,在本例中为My Panel
。要在标题中显示 & 字符,请使用两个 & 字符。remove、default 和 factory(区分大小写)为保留词语。要将上述词语之一用作标签,请在词语前面加一个反斜杠字符 (\)。例如,输入
\remove
将得到 remove。通过从弹出式菜单中选择可用的
TitlePosition
属性值之一来指定面板标题的位置,在本例中为lefttop
。您可以将标题置于面板顶部或底部的左侧、中间或右侧。如果要将面板的位置或大小设置为精确值,请修改其
Position
属性。
按钮组
要创建标题为 My Button Group 的按钮组,如下图所示,请执行以下操作:
通过将
Title
属性设置为所需的值来指定按钮组标题,在本例中为My Button Group
。要在标题中显示 & 字符,请使用两个 & 字符。remove、default 和 factory(区分大小写)为保留词语。要将上述词语之一用作标签,请在词语前面加一个反斜杠字符 (\)。例如,输入
\remove
将得到 remove。通过从弹出式菜单中选择可用的
TitlePosition
属性值之一来指定按钮组标题的位置,在本例中为lefttop
。您可以将标题置于按钮组顶部或底部的左侧、中间或右侧。如果要将按钮组的位置或大小设置为精确值,请修改其
Position
属性。
坐标区
坐标区允许您使用以下命令来显示图和图像等:plot
、surf
、line
、bar
、pie
、contour
和 mesh
。
要定义坐标区,必须设置一些属性。要完成此操作,请执行以下步骤:
使用属性检查器修改相应的属性。通过选择视图 > 属性检查器或点击属性检查器按钮 ,打开属性检查器。
在布局区域中,选择要定义的组件。
后续主题说明坐标区的常用属性,并提供一个简单示例。
常用属性
下表显示了描述坐标区所需的最常用属性:
属性 | 值 | 描述 |
---|---|---|
|
| 指定绘制操作是添加图形、替换图形并将坐标区属性重置为默认值,还是仅替换图形。 |
位置 | 4 元素向量:[与左侧的距离, 与底部的距离, 宽度, 高度]。 | 组件的大小及相对于其父组件的位置。 |
单位 |
| 用于解释位置向量的测量单位 |
有关完整的属性列表以及表中所列属性的详细信息,请参阅 Axes 属性。
有关坐标区对象的详细信息,请参阅以下命令:plot
、surf
、line
、bar
、polar
、pie
、contour
、imagesc
和 mesh
。
默认情况下,这些绘图函数大多都会根据其 NextPlot
属性的设置重置坐标区属性,这可能会导致意外的行为,例如重置轴范围以及删除坐标区上下文菜单和回调。有关设置 NextPlot
属性的信息,请参阅创建坐标区。
创建坐标区
下面是使用 GUIDE 创建的 App 中的坐标区:
在 GUIDE 中创建坐标区对象时,请遵守以下规范:
允许在布局编辑器中显示的框的外面放置刻度线。上述坐标区在布局编辑器中的外观如下所示;这样的放置方式允许在坐标区的左侧和底部留出空间显示刻度线。在坐标区上进行绘制的函数会相应地更新刻度线。
使用代码文件中的
title
、xlabel
、ylabel
、zlabel
和text
函数对坐标区组件加标签。例如,xlh = (axes_handle,'Years')
对 X 轴添加标签
Years
。X 轴标签的句柄是xlh
。remove
、default
和factory
(区分大小写)为保留词语。要在组件文本中使用这些词语之一,请在词语前面添加反斜杠字符 (\
)。例如,输入\remove
将得到 remove。如果要将坐标区的位置或大小设置为精确值,请修改其
Position
属性。如果自定义坐标区属性,则当
NextPlot
属性的默认值为'replace'
时,每次在坐标区上绘制图形时,其中一些属性(例如回调、字体特征以及轴范围和刻度)可能都会重置为默认值。要保留所需的自定义属性,请在属性检查器中将NextPlot
设置为'replacechildren'
,如下所示。
表
您可以使用表在二维表中显示数据。您可以使用属性检查器来获取和设置对象属性值。
常用属性
下表列出了表组件的最常用属性。它们按照在表属性编辑器中出现的顺序进行分组。有关所有表属性的详细信息,请参考 uitable
文档:
组 | 属性 | 值 | 描述 |
---|---|---|---|
列 | ColumnName | 由字符向量组成的 1×n 元胞数组 | {'numbered'} | 空矩阵 ([]) | 列标题标签。 |
ColumnFormat | 字符向量元胞数组 | 确定列的显示和可编辑性 | |
ColumnWidth | 1×n 元胞数组或 'auto' | 每列的宽度(以像素为单位);单个列宽也可以设置为 'auto' | |
ColumnEditable | 1×n 逻辑矩阵 | 标量逻辑值 | 空矩阵 ([]) | 确定列中的数据为可编辑 | |
行 | RowName | 1×n 字符向量元胞数组 | 行标题标签名称 |
颜色 | BackgroundColor | 由 RGB 三元组组成的 n×3 矩阵 | 单元格的背景颜色 |
RowStriping | {on} | off | 表行的隔行着色 | |
数据 | Data | 数值、逻辑值或字符数据矩阵或元胞数组 | 表数据。 |
创建表
要在 GUIDE 中创建一个如下图所示的具有表的 UI,请执行以下操作:
将表图标拖到布局编辑器上,然后在表中点击右键。从表的上下文菜单中,选择表属性编辑器。当您选中了表本身时,也可以从工具菜单中选择表属性编辑器。
使用表属性编辑器. 以这种方式打开时,表属性编辑器会显示列窗格。您也可以通过点击其表属性编辑器图标之一 从属性检查器中打开它,在这种情况下,表属性编辑器将打开并显示适合您所点击的属性的窗格。
点击表属性编辑器左侧列表中的项会更改右侧窗格的内容。使用这些项可激活用于指定表的列、行、数据和颜色选项的控件。
列和行窗格各有一个数据输入区域,您可以在其中逐行或逐列键入名称和设置属性。一次只能编辑一个行或列定义。这些窗格包含一个垂直组,其中包括五个用于编辑和导航的按钮:
按钮 | 用途 | 快捷键 | |
---|---|---|---|
Windows | Macintosh | ||
插入 | 在当前列或行定义条目下插入一个新的列或行定义条目 | Insert | Insert |
删除 | 删除当前列或行定义条目(不可撤消) | Ctrl+D | Cmd+D |
复制 | 将所选条目的副本插入其下的新行中 | Ctrl+P | Cmd+P |
向上 | 将所选条目上移一行 | Ctrl+ 向上箭头 | Cmd+ 上箭头 |
向下 | 将所选条目下移一行 | Ctrl+ 向下箭头 | Cmd+ 下箭头 |
键盘等效键仅在光标位于数据输入区域时才起作用。除了上面列出的各项,键入 Ctrl+T 或 Cmd+T 会选中包含光标的整个字段进行编辑(如果该字段包含文本)。
要保存在表属性编辑器中对表所做的更改,请点击确定,或点击应用提交更改并继续使用表属性编辑器。
设置列属性. 点击插入再添加两个列。
选择显示下面输入的名称作为列标题,并通过在名称组中输入 Rate、Amount、Available 和 Fixed/Adj 列来设置 ColumnName
。对于 Available 和 Fixed/Adj 列,将 ColumnEditable
属性设置为 on
。最后设置四列的 ColumnFormat
。
对于 Rate 列,选择数值。对于 Amount 列,选择自定义,并在自定义格式编辑器中选择银行。
将 Available 列保留为默认值。这允许 MATLAB 根据表的 Data
属性值进行选择。对于 Fixed/Adj 列,选择选项列表创建一个弹出式菜单。在选项列表编辑器中,点击插入以添加第二个选项,并键入 Fixed 和 Adjustable 作为两个选项。
注意
用户要从选项列表中选择项目,列表所占列的 ColumnEditable
属性必须设置为 'true'
。仅当列可编辑时,弹出式控件才会出现。
设置行属性. 在“行”选项卡中,保留默认的 RowName
、显示编号的行标题。
设置数据属性. 使用 Data
属性指定表中的数据。请先在命令行窗口中创建数据,然后在 GUIDE 中指定该数据。在此示例中,键入:
dat = {6.125, 456.3457, true, 'Fixed';... 6.75, 510.2342, false, 'Adjustable';... 7, 658.2, false, 'Fixed';};
在表属性编辑器中,选择您定义的数据,然后选择将数据值更改为下面工作区中选定的变量。
设置颜色属性. 在“颜色”选项卡中为您的表指定 BackgroundColor
和 RowStriping
。
您可以通过属性检查器将其他 uitable
属性更改为表。
调整 GUIDE UI 组件的大小
您可以通过以下方式之一调整组件的大小:
拖动组件的一个角
选择要调整大小的组件。点击其中一个角图柄并拖动它,直到组件达到所需的大小。
设置组件的位置属性
选择一个或多个要调整大小的组件。然后选择视图 > 属性检查器或点击属性检查器按钮 。
在属性检查器中,滚动到
Units
属性,并注意当前设置为characters
还是normalized
。点击Units
旁边的按钮,然后从弹出式菜单中将设置更改为inches
。点击
Position
旁边的 + 符号。属性检查器显示Position
属性的元素。键入组件要采用的
width
和height
值。将
Units
属性重置为其以前的设置,即characters
或normalized
。
要选择多个组件,这些组件必须具有相同的父组件。也就是说,它们必须包含在同一个图窗、面板或按钮组中。将 Units
属性设为 characters
(不可调整大小的 UI)或 normalized
(可调整大小的 UI),这将为 UI 提供更一致的跨平台外观。