小部件类

这些基本控件（如按钮、下拉列表和滚动条）旨在供用户直接使用。

QCheckBox	带文本标签的复选框
QComboBox	将按钮与下拉列表结合
QCommandLinkButton	Vista 风格的命令链接按钮
QDateEdit	基于 QDateTimeEdit 控件的日期编辑控件
QDateTimeEdit	用于编辑日期和时间的小部件
QDial	带圆角的范围控件（如车速表或电位计）
QDoubleSpinBox	接受双精度数值的旋转框控件
QFocusFrame	焦点框（可位于控件正常可绘制区域之外）
QFontComboBox	允许用户选择字体家族的下拉列表控件
QLCDNumber	以类似LCD的数字显示数值
QLabel	文本或图像显示
QLineEdit	单行文本编辑器
QMenu	用于菜单栏、上下文菜单及其他弹出菜单的菜单控件
QProgressBar	水平或垂直进度条
QPushButton	命令按钮
QRadioButton	带有文本标签的单选按钮
QScrollArea	滚动视图至另一个控件
QScrollBar	垂直或水平滚动条
QSizeGrip	用于调整顶级窗口大小的调整大小控点
QSlider	垂直或水平滑块
QSpinBox	旋转框控件
QTabBar	标签栏，例如用于带标签的对话框
QTabWidget	标签控件堆叠
QTimeEdit	基于 QDateTimeEdit 控件的时间编辑控件
QToolBox	带标签控件项的列
QToolButton	用于命令或选项的快速访问按钮，通常用于 QToolBar 内
QWidget	所有用户界面对象的基类

高级 GUI 控件（例如选项卡控件和进度条）提供了更复杂的用户界面控件。

使用树形视图显示内容的目录小部件

显示月份、年份和所选日期的日历小部件

显示命令列表的撤销堆栈

QCalendarWidget	基于月份的日历控件，允许用户选择日期
QColumnView	列视图的模型/视图实现
QDataWidgetMapper	数据模型的某个部分与控件之间的映射
QListView	基于模型的列表或图标视图
QTableView	表格视图的默认模型/视图实现
QTreeView	树视图的默认模型/视图实现
QUndoView	显示 QUndoStack 的内容

抽象控件类是基类。它们不能作为独立类使用，但当被子类化时会提供相应功能。

QAbstractButton	按钮控件的抽象基类，提供按钮共有的功能
QAbstractScrollArea	带有按需滚动条的滚动区域
QAbstractSlider	范围内的整数值
QAbstractSpinBox	用于显示值的旋转框和行编辑框
QDialog	对话框窗口的基类
QFrame	可具有边框的小部件的基类

诸如分割器、选项卡栏、按钮组等类，用于将GUI基元组织和分组，从而构建更复杂的应用程序和对话框。

QButtonGroup	用于组织按钮控件组的容器
QGroupBox	带有标题的组框边框
QSplitter	实现了一个分隔条控件
QSplitterHandle	分隔条的处理功能
QStackedWidget	小部件堆栈，其中每次仅显示一个小部件
QTabWidget	带标签页的小部件堆栈

图形视图类

QAbstractGraphicsShapeItem	所有路径项的公共基类
QGraphicsAnchor	表示 QGraphicsAnchorLayout 中两个项目之间的锚点
QGraphicsAnchorLayout	可在图形视图中将小部件相互锚定的布局
QGraphicsEffect	所有Graphical Effects的基类
QGraphicsEllipseItem	可添加到 QGraphicsScene 中的椭圆项
QGraphicsGridLayout	用于在图形视图中管理小部件的网格布局
QGraphicsItem	QGraphicsScene 中所有图形项的基类
QGraphicsItemGroup	将一组项目视为单个项目的容器
QGraphicsLayout	Graphics View 中所有布局的基类
QGraphicsLayoutItem	可通过继承使其自定义项由布局进行管理
QGraphicsLineItem	可添加到 QGraphicsScene 中的行级项
QGraphicsLinearLayout	用于在 Graphics View 中管理小部件的水平或垂直布局
QGraphicsObject	所有需要信号、槽和属性的图形项的基类
QGraphicsPathItem	可添加到 QGraphicsScene 中的路径项
QGraphicsPixmapItem	可添加到 QGraphicsScene 中的位图项目
QGraphicsPolygonItem	可添加到 QGraphicsScene 中的多边形项
QGraphicsProxyWidget	用于将 QWidget 嵌入 QGraphicsScene 的代理层
QGraphicsRectItem	可添加到 QGraphicsScene 中的矩形项
QGraphicsScene	用于管理大量 2D 图形项的 Surface
QGraphicsSceneContextMenuEvent	图形视图框架中的上下文菜单事件
QGraphicsSceneDragDropEvent	图形视图框架中的拖放事件
QGraphicsSceneEvent	所有图形视图相关事件的基类
QGraphicsSceneHelpEvent	请求工具提示时的事件
QGraphicsSceneHoverEvent	图形视图框架中的悬停事件
QGraphicsSceneMouseEvent	图形视图框架中的鼠标事件
QGraphicsSceneMoveEvent	图形视图框架中控件移动的事件
QGraphicsSceneResizeEvent	图形视图框架中控件调整大小的事件
QGraphicsSceneWheelEvent	图形视图框架中的滚轮事件
QGraphicsSimpleTextItem	可添加到 QGraphicsScene 中的简单文本项
QGraphicsSvgItem	可用于渲染 SVG 文件内容的 QGraphicsItem
QGraphicsTextItem	可添加到 QGraphicsScene 中以显示格式化文本的文本项
QGraphicsTransform	用于在 QGraphicsItem 上构建高级变换的抽象基类
QGraphicsView	用于显示 QGraphicsScene 内容的控件
QGraphicsWidget	QGraphicsScene 中所有小部件项的基类
QStyleOptionGraphicsItem	用于描述绘制 QGraphicsItem 所需的参数

模型/视图类

QAbstractItemDelegate	用于显示和编辑来自模型的数据项
QAbstractItemModel	项目模型类的抽象接口
QAbstractItemView	项视图类的基本功能
QAbstractListModel	可通过继承创建一维列表模型的抽象模型
QAbstractProxyModel	代理项目模型的基类，可执行排序、过滤或其他数据处理任务
QAbstractTableModel	可通过继承创建表模型的抽象模型
QColumnView	列视图的模型/视图实现
QConcatenateTablesProxyModel	代理多个源模型，并将它们的行拼接在一起
QDataWidgetMapper	数据模型某部分与控件之间的映射
QFileSystemModel	用于本地文件系统的数据模型
QHeaderView	项目视图的标题行或标题列
QIdentityProxyModel	原样代理其源模型
QItemDelegate	用于显示和编辑模型中数据项的功能
QItemEditorCreator	无需继承 QItemEditorCreatorBase 即可创建项目编辑器创建器基类
QItemEditorCreatorBase	在实现新的项目编辑器创建器时必须继承的抽象基类
QItemEditorFactory	用于在视图和委托中编辑项目数据的控件
QItemSelection	管理模型中已选项目的相关信息
QItemSelectionModel	跟踪视图中选中的项目
QItemSelectionRange	管理模型中选定项目范围的相关信息
QListView	模型的列表或图标视图
QListWidget	基于项目的列表控件
QListWidgetItem	用于与 QListWidget 项目视图类配合使用的项目
QModelIndex	用于在数据模型中定位数据
QModelRoleData	包含一个角色及其关联的数据
QModelRoleDataSpan	覆盖 QModelRoleData 对象
QPersistentModelIndex	用于在数据模型中定位数据
QRangeModel	为任何 C++ 范围实现 QAbstractItemModel
QRangeModel::ItemAccess	该模板提供了一个自定义点，用于控制 QRangeModel 如何访问单个项的角色数据
QRangeModel::RowOptions	该模板提供了一个自定义点，用于控制 QRangeModel 如何表示用作行的类型
QRangeModelAdapter	以符合 QAbstractItemModel 规范的方式访问任何 C++ 范围
QRangeModelAdapter::ColumnIterator	提供一个针对模型行中各列的 STL 风格非 const 迭代器
QRangeModelAdapter::ConstColumnIterator	提供一个用于遍历模型行中各列的 STL 风格非 const 迭代器
QRangeModelAdapter::ConstRowIterator	提供一个用于遍历模型行且符合 STL 风格的 const 迭代器
QRangeModelAdapter::ConstRowReference	围绕 QRangeModel 中 const 行创建的引用包装器
QRangeModelAdapter::DataReference	围绕 QRangeModel 中项的引用包装器
QRangeModelAdapter::RowIterator	提供一个遍历模型行并遵循 STL 风格的非 const 迭代器
QRangeModelAdapter::RowReference	围绕 QRangeModel 中一行创建的引用包装器
QRangeModelAdapter::RowReferenceBase	RowReference 和 ConstRowReference 的通用 API
QSortFilterProxyModel	支持对在另一个模型与视图之间传递的数据进行排序和过滤
QStandardItem	用于与 QStandardItemModel 类配合使用的项
QStandardItemEditorCreator	无需继承 QItemEditorCreatorBase 即可注册小部件
QStandardItemModel	用于存储自定义数据的通用模型
QStringListModel	向视图提供字符串的模型
QStyledItemDelegate	用于显示和编辑模型中数据项的功能
QTableView	表格视图的默认模型/视图实现
QTableWidget	基于项的表格视图及其默认模型
QTableWidgetItem	用于 QTableWidget 类的项目
QTableWidgetSelectionRange	在不使用模型索引和选择模型的情况下与模型中的选择项交互的方法
QTreeView	树视图的默认模型/视图实现
QTreeWidget	使用预定义树模型的树视图
QTreeWidgetItem	用于 QTreeWidget 便利类的项目
QTreeWidgetItemIterator	遍历 QTreeWidget 实例中项的方法

QDockWidget	可停靠在 QMainWindow 内，或作为桌面上的顶级窗口浮动显示的控件
QMainWindow	主应用程序窗口
QMdiArea	显示 MDI 窗口的区域
QMdiSubWindow	QMdiArea 的子窗口类
QMenu	用于菜单栏、上下文菜单及其他弹出菜单的菜单控件
QMenuBar	水平菜单栏
QSizeGrip	用于调整顶级窗口大小的调整大小控点
QStatusBar	适用于显示状态信息的水平条
QToolBar	包含一组控件的可移动面板
QWidgetAction	通过接口扩展 QAction，以便将自定义控件插入到基于操作的容器（如工具栏）中

用于自定义 UI 外观和样式的类。

QColor	基于 RGB、HSV 或 CMYK 值的颜色
QColorSpace	色彩空间抽象
QColorTransform	颜色空间之间的转换
QCommonStyle	封装了GUI的通用外观和风格
QCursor	具有任意形状的鼠标光标
QFont	指定用于绘制文本的字体的查询
QFontDatabase	关于底层窗口系统中可用字体的信息
QFontInfo	关于字体的通用信息
QGraphicsAnchor	表示 QGraphicsAnchorLayout 中两个项目之间的锚点
QGraphicsAnchorLayout	可在 Graphics View 中将小部件相互锚定的布局
QPalette	包含每个小部件状态的颜色组
QStyle	封装GUI外观和风格的抽象基类
QStyleFactory	用于创建 QStyle 对象
QStyleHintReturn	返回基本数据类型以外内容的样式提示
QStyleHintReturnMask	返回 QRegion 的样式提示
QStyleHintReturnVariant	返回 QVariant 的样式提示
QStyleKitStyle	将 Qt Labs StyleKit 样式应用于Qt Widgets
QStyleOption	存储 QStyle 函数使用的参数
QStylePainter	用于在小部件内部绘制 QStyle 元素的便捷类

布局类

QBoxLayout	将子小部件水平或垂直对齐
QButtonGroup	用于组织按钮小部件组的容器
QFormLayout	管理输入控件及其关联标签的表单
QGraphicsAnchor	表示 QGraphicsAnchorLayout 中两个项目之间的锚点
QGraphicsAnchorLayout	可在图形视图中将小部件锚定在一起的布局
QGridLayout	将控件以网格形式布局
QGroupBox	带有标题的组框框架
QHBoxLayout	将控件水平对齐
QLayout	几何管理器的基类
QLayoutItem	由 QLayout 操作的抽象项目
QSizePolicy	描述水平和垂直调整大小策略的布局属性
QSpacerItem	布局中的空白区域
QStackedLayout	一次仅显示一个小部件的小部件堆栈
QStackedWidget	小部件堆栈，其中每次仅显示一个小部件
QVBoxLayout	将小部件垂直排列
QWidgetItem	代表小部件的布局项

控件库

© 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.

小部件类

控件类

基本控件类

高级控件类

抽象控件类

组织器控件类

图形视图类

模型/视图类

布局类

小部件类

控件类

基本控件类

高级控件类

抽象控件类

组织器控件类

图形视图类

模型/视图类

主窗口及相关类

与小部件外观和样式相关的类

布局类