Qt Widgets

Qt Widgets 模块提供了一套 UI 元素，用于创建经典桌面风格的用户界面。参见用户界面概述，获取更多有关使用小部件的信息。

小部件

小部件是 Qt 中创建用户界面的主要元素。小部件可以显示数据和状态信息、接收用户输入，以及为其他应分组的 widget 提供容器。没有嵌入到父 widget 中的 widget 称为窗口。

QWidget 类提供了对屏幕进行渲染和处理用户输入事件的基类。Qt 提供的所有 UI 元素要么是 QWidget 的子类，要么用于与 QWidget 的子类一起使用。要创建自定义小部件，请派生 QWidget 或合适的子类，并重新实现虚拟事件处理程序。

• 窗口和对话框小部件
• 应用主窗口
• 对话框窗口
• 小部件中的键盘焦点

风格

风格代表小部件进行绘制并封装了 GUI 的外观和感觉。Qt 的内置小部件使用 QStyle 类执行几乎所有绘制任务，确保它们看起来与等效的本地小部件完全相同。

Qt 风格表 是一种强大的机制，除了通过派生 QStyle 实现的打描之外，它允许你自定义小部件的外观。

布局

布局 是一种优雅且灵活的方式，用于自动在其容器内排列子小部件。每个小部件通过 sizeHint 和 sizePolicy 属性将其大小需求报告给布局，布局相应地分配可用空间。

Qt Designer 是一种强大的工具，可以用于交互式地创建和排列布局中的小部件。

模型/视图类

模型/视图架构提供了一种类，用于管理将数据呈现给用户的方式。使用列表和表格的数据驱动应用程序被结构化为使用模型、视图和代理来分割数据和视图。

图形视图

图形视图框架用于管理和交互大量定制 2D 图形项，并为项目提供了一个可視化的视图小部件，支持缩放和旋转。

使用模块

使用 Qt 模块的 C++ API 需要链接到模块库，无论是直接链接还是通过其他依赖。包括 CMake 和 qmake 在内的一些构建工具为此提供了专属支持。

使用 CMake 构建

使用 find_package() 命令在 Qt6 软件包中查找所需模块组件。

find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)

有关更多详细信息，请参阅 使用 CMake 构建 概述。

使用 qmake 构建

若要为使用 qmake 构建配置模块，请将模块添加到项目 .pro 文件中 QT 变量的值中。

QT += widgets

文章和指南

• 小部件教程
• 使用 Qt 小部件编程入门
• 创建基于 Qt 小部件的应用程序
• 模型/视图教程

示例

• Qt 小部件示例
• 布局示例
• 工具示例

API 参考

• Qt 小部件 C++ 类
  • 基本小部件类
  • 高级小部件类
  • 抽象小部件类
  • 组织者小部件类
  • 图形视图类
  • 模型/视图类
  • 主窗口及相关类
  • 小部件外观和样式相关类
  • 布局类
• Qt 风格表参考

模块演进

Qt 小部件变更 列出了为 Qt 6 系列Qt 实现的模块 API 和功能中的重要变更。

许可证

Qt 小部件模块可在 Qt 公司 的商业许可下使用。此外，它还可在免费软件许可下使用：GNU 软件基金会发布的 GNU Lesser General Public License 版本 3，或 GNU General Public License 版本 2。有关更多信息，请参阅 Qt 许可。