本页内容

容器控件

Qt Quick Controls 提供了一系列类似容器的控件。

ApplicationWindow

支持页眉和页脚的样式化顶级窗口

Container

提供容器通用功能的抽象基类

Frame

用于逻辑控件组的视觉框架

GroupBox

用于控制项逻辑组的可视化框架和标题

HorizontalHeaderView

提供与 TableView 配套的水平页眉视图

Page

支持页眉和页脚的样式化页面控件

Pane

提供与应用程序样式和主题相匹配的背景

ScrollView

可滚动视图

SplitView

在每个项目之间放置可拖动的分隔线来布局项目

StackView

提供基于堆栈的导航模型

SwipeView

允许用户通过横向滑动来浏览页面

TabBar

允许用户在不同的视图或子任务之间切换

ToolBar

用于容纳上下文相关控件的容器

VerticalHeaderView

提供与 TableView 配套的垂直标题视图

每种容器类型均可用于将一组控件聚合在一起。以下各节将根据具体用例,提供选择合适容器类型的指导原则。

ApplicationWindow 控件

包含菜单栏、页眉、内容区和页脚的窗口布局

ApplicationWindow 用于创建应用程序的根窗口,并便于向该窗口添加可选的页眉和页脚。

Frame 控件

包含标有“电子邮件”、“日历”、“联系人”的复选框的框架

Frame 用于在视觉框架内将一组逻辑相关的控件布局在一起。

GroupBox 控件

带有标题和边框、内含复选框的组框

GroupBox 用于在带有标题的可视框架内,将一组逻辑上的控件布局在一起。

Page 控件

包含页眉、内容区和页脚的页面线框图

Page 提供特定于页面的页眉和页脚项目。虽然完全可以使用ApplicationWindow 来设置页眉和页脚,但如果页眉和页脚在不同屏幕上有所不同,那么最好使用Page 。

窗格控件

包含带背景项目的窗格

Pane 提供与应用程序样式和主题相匹配的背景颜色。窗格本身不提供布局功能,需要您手动定位其内容,例如通过使用RowLayout 或ColumnLayout 。

ScrollView 控件

ScrollView 布局,显示带有滚动条的可滚动内容区域

ScrollView 为用户定义的内容提供滚动功能。

StackView 控件

堆栈视图图示:显示了堆叠的页面,其中最上方的页面可见

StackView 采用“后进先出”原则将内容页面组织成堆栈:最后“压入”堆栈的项目将首先被“弹出”,且最顶部的项目始终处于可见状态。

SwipeView 控件

滑动视图图示,显示以可滑动条带形式排列的页面

SwipeView 将内容页面组织成一个可滑动的条带。

TabBar 控件

显示多个标签页以组织内容的标签栏图

TabBar 将内容页面组织成标签页。

ToolBar 控件

包含工具按钮的工具栏

ToolBar 是应用程序级和上下文相关操作及控件的容器。

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.