Qt Widgets C++ Classes

Qt Widgets 模块在Qt GUI 的基础上扩展了C++控件功能。更多内容...

类

QAbstractButton	按钮控件的抽象基类，提供按钮共有的功能
QAbstractGraphicsShapeItem	所有路径项的公共基类
QAbstractItemDelegate	用于显示和编辑来自模型的数据项
QAbstractItemView	项目视图类的基本功能
QAbstractScrollArea	带有按需滚动条的滚动区域
QAbstractSlider	范围内的整数值
QAbstractSpinBox	用于显示值的旋转框和行编辑框
QAccessibleWidget	为 QWidgets 实现 QAccessibleInterface 接口
QApplication	管理 GUI 应用程序的控制流和主要设置
QBoxLayout	将子控件水平或垂直排列
QButtonGroup	用于组织按钮控件组的容器
QCalendarWidget	基于月份的日历控件，允许用户选择日期
QCheckBox	带文本标签的复选框
QColorDialog	用于指定颜色的对话框控件
QColumnView	列视图的模型/视图实现
QComboBox	将按钮与下拉列表结合
QCommandLinkButton	Vista风格的命令链接按钮
QCommonStyle	封装了GUI的通用外观和风格
QCompleter	基于项目模型的自动补全
QDataWidgetMapper	数据模型的某个部分与控件之间的映射
QDateEdit	基于 QDateTimeEdit 控件的日期编辑控件
QDateTimeEdit	用于编辑日期和时间的控件
QDial	带圆角的范围控件（如速度表或电位计）
QDialog	对话框窗口的基类
QDialogButtonBox	根据当前控件样式以适当布局显示按钮的控件
QDockWidget	可停靠在 QMainWindow 内，或作为桌面上的顶级窗口浮动显示的小部件
QDoubleSpinBox	接受双精度浮点数（double）的旋转框控件
QErrorMessage	错误消息显示对话框
QFileDialog	提供一个对话框，允许用户选择文件或目录
QFileIconProvider	用于 QFileSystemModel 类的文件图标
QFocusFrame	焦点框，其范围可超出控件的正常可绘制区域
QFontComboBox	允许用户选择字体家族的下拉列表
QFontDialog	用于选择字体的对话框控件
QFormLayout	管理输入控件及其关联标签的表单
QFormLayout::TakeRowResult	包含 QFormLayout::takeRow() 调用的结果
QFrame	可具有边框的小部件的基类
QGesture	表示一个手势，包含描述相应用户输入的属性
QGestureEvent	已触发手势的描述
QGestureRecognizer	手势识别的基础架构
QGraphicsAnchor	表示 QGraphicsAnchorLayout 中两个项目之间的锚点
QGraphicsAnchorLayout	一种布局，可在图形视图中将小部件锚定在一起
QGraphicsBlurEffect	模糊效果
QGraphicsColorizeEffect	着色效果
QGraphicsDropShadowEffect	阴影效果
QGraphicsEffect	所有Graphical Effects的基类
QGraphicsEllipseItem	可添加到 QGraphicsScene 中的椭圆控件
QGraphicsGridLayout	用于在 Graphics View 中管理小部件的网格布局
QGraphicsItem	QGraphicsScene 中所有图形项的基类
QGraphicsItemGroup	将一组项目视为单个项目的容器
QGraphicsLayout	Graphics View 中所有布局的基类
QGraphicsLayoutItem	可通过继承使其自定义项由布局进行管理
QGraphicsLineItem	可添加到 QGraphicsScene 中的行项目
QGraphicsLinearLayout	用于在 Graphics View 中管理小部件的水平或垂直布局
QGraphicsObject	所有需要信号、槽和属性的图形项的基类
QGraphicsOpacityEffect	不透明度效果
QGraphicsPathItem	可添加到 QGraphicsScene 中的路径项
QGraphicsPixmapItem	可添加到 QGraphicsScene 中的位图项
QGraphicsPolygonItem	可添加到 QGraphicsScene 中的多边形项目
QGraphicsProxyWidget	用于将 QWidget 嵌入 QGraphicsScene 的代理层
QGraphicsRectItem	可添加到 QGraphicsScene 中的矩形项
QGraphicsRotation	围绕给定轴的旋转变换
QGraphicsScale	缩放变换
QGraphicsScene	用于管理大量 2D 图形项的 Surface
QGraphicsSceneContextMenuEvent	图形视图框架中的上下文菜单事件
QGraphicsSceneDragDropEvent	图形视图框架中的拖放事件
QGraphicsSceneEvent	所有图形视图相关事件的基类
QGraphicsSceneHelpEvent	请求工具提示时的事件
QGraphicsSceneHoverEvent	图形视图框架中的悬停事件
QGraphicsSceneMouseEvent	图形视图框架中的鼠标事件
QGraphicsSceneMoveEvent	图形视图框架中控件移动的事件
QGraphicsSceneResizeEvent	图形视图框架中有关小部件调整大小的事件
QGraphicsSceneWheelEvent	图形视图框架中的滚轮事件
QGraphicsSimpleTextItem	可添加到 QGraphicsScene 中的简单文本项
QGraphicsTextItem	可添加到 QGraphicsScene 中以显示格式化文本的文本项
QGraphicsTransform	用于在 QGraphicsItem 上构建高级变换的抽象基类
QGraphicsView	用于显示 QGraphicsScene 内容的控件
QGraphicsWidget	QGraphicsScene 中所有小部件项的基类
QGridLayout	将控件以网格形式布局
QGroupBox	带有标题的组框
QHBoxLayout	将控件水平对齐
QHeaderView	项目视图的标题行或标题列
QInputDialog	用于从用户处获取单个值的简单便捷对话框
QItemDelegate	用于显示和编辑模型中数据项的功能
QItemEditorCreator	无需继承 QItemEditorCreatorBase 即可创建项目编辑器创建器基类
QItemEditorCreatorBase	在实现新的项目编辑器创建器时必须继承的抽象基类
QItemEditorFactory	用于在视图和委托中编辑项目数据的小部件
QKeySequenceEdit	允许输入 QKeySequence
QLCDNumber	以类似LCD的数字格式显示数字
QLabel	文本或图像显示
QLayout	几何管理器的基类
QLayoutItem	由 QLayout 操作的抽象项目
QLineEdit	单行文本编辑器
QListView	基于模型的列表或图标视图
QListWidget	基于项的列表控件
QListWidgetItem	用于 QListWidget 项目视图类的项目
QMainWindow	主应用程序窗口
QMdiArea	显示 MDI 窗口的区域
QMdiSubWindow	QMdiArea 的子窗口类
QMenu	用于菜单栏、上下文菜单及其他弹出菜单的菜单控件
QMenuBar	水平菜单栏
QMessageBox	用于向用户提供信息、向用户提问并接收答复的模态对话框
QPanGesture	描述用户执行的平移手势
QPinchGesture	描述用户执行的捏合手势
QPlainTextDocumentLayout	为 QTextDocument 实现纯文本布局
QPlainTextEdit	用于编辑和显示纯文本的小部件
QProgressBar	水平或垂直进度条
QProgressDialog	对慢速操作进度的反馈
QProxyStyle	用于简化动态重写 QStyle 元素的便利类
QPushButton	命令按钮
QRadioButton	带文本标签的单选按钮
QRhiWidget	用于通过加速图形 API（如 Vulkan、Metal 或 Direct 3D）渲染 3D 图形的控件
QRubberBand	可表示选中状态或边界的矩形或线条
QScrollArea	滚动视图到另一个控件上
QScrollBar	垂直或水平滚动条
QScroller	为任何滚动控件或图形项启用惯性滚动
QScrollerProperties	用于存储 QScroller 的设置
QSizeGrip	用于调整顶级窗口大小的调整大小控点
QSizePolicy	描述水平和垂直调整大小策略的布局属性
QSlider	垂直或水平滑块
QSpacerItem	布局中的空白区域
QSpinBox	旋转框控件
QSplashScreen	可在应用程序启动时显示的启动画面
QSplitter	实现了一个分隔条控件
QSplitterHandle	分隔条的控件功能
QStackedLayout	组件堆栈，每次仅显示一个组件
QStackedWidget	组件堆栈，其中每次仅显示一个组件
QStandardItemEditorCreator	无需继承 QItemEditorCreatorBase 即可注册控件
QStatusBar	适用于显示状态信息的水平条
QStyle	封装GUI外观和风格的抽象基类
QStyleFactory	创建 QStyle 对象
QStyleHintReturn	返回基本数据类型以外内容的样式提示
QStyleHintReturnMask	返回 QRegion 的样式提示
QStyleHintReturnVariant	返回 QVariant 的样式提示
QStyleOption	存储 QStyle 函数所使用的参数
QStyleOptionButton	用于描述绘制按钮的参数
QStyleOptionComboBox	用于描述绘制下拉列表框的参数
QStyleOptionComplex	用于存储所有复杂控件共有的参数
QStyleOptionDockWidget	用于描述绘制停靠控件的参数
QStyleOptionFocusRect	用于描述使用 QStyle 绘制焦点矩形的参数
QStyleOptionFrame	用于描述绘制边框的参数
QStyleOptionGraphicsItem	用于描述绘制 QGraphicsItem 所需的参数
QStyleOptionGroupBox	描述绘制组框所需的参数
QStyleOptionHeader	用于描述绘制标题栏的参数
QStyleOptionHeaderV2	用于描述绘制标题栏的参数
QStyleOptionMenuItem	用于描述绘制菜单项所需的参数
QStyleOptionMenuItemV2	通过新增成员扩展了 QStyleOptionMenuItem
QStyleOptionProgressBar	用于描述绘制进度条所需的参数
QStyleOptionRubberBand	用于描述绘制弹力带所需的参数
QStyleOptionSizeGrip	用于描述绘制大小控点所需的参数
QStyleOptionSlider	用于描述绘制滑块所需的参数
QStyleOptionSpinBox	用于描述绘制旋转框所需的参数
QStyleOptionTab	用于描述绘制标签栏所需的参数
QStyleOptionTabBarBase	用于描述选项卡栏的基础部分，即选项卡栏通常与之重叠的部分
QStyleOptionTabWidgetFrame	用于描述绘制选项卡控件周围边框的参数
QStyleOptionTitleBar	用于描述绘制标题栏的参数
QStyleOptionToolBar	用于描述绘制工具栏所需的参数
QStyleOptionToolBox	用于描述绘制工具箱所需的参数
QStyleOptionToolButton	用于描述绘制工具按钮的参数
QStyleOptionViewItem	用于描述在视图控件中绘制项目所用的参数
QStylePainter	用于在小部件内部绘制 QStyle 元素的便利类
QStylePlugin	自定义 QStyle 插件的抽象基类
QStyledItemDelegate	用于显示和编辑模型中数据项的功能
QSwipeGesture	描述用户执行的滑动手势
QSystemTrayIcon	系统托盘中应用程序的图标
QTabBar	标签栏，例如用于带标签的对话框
QTabWidget	标签式小部件堆栈
QTableView	表格视图的默认模型/视图实现
QTableWidget	带有默认模型的基于项的表格视图
QTableWidgetItem	用于 QTableWidget 类的项目
QTableWidgetSelectionRange	无需使用模型索引和选择模型即可与模型中的选择项进行交互的方法
QTapAndHoldGesture	描述用户执行的轻触并长按（也称为 LongTap）手势
QTapGesture	描述用户执行的轻触手势
QTextBrowser	支持超文本导航的富文本浏览器
QTextEdit	用于编辑和显示纯文本及富文本的控件
QTextEdit::ExtraSelection	QTextEdit::ExtraSelection 结构提供了一种为文档中给定选区指定字符格式的方法
QTileRules	用于绘制被划分为九个区域的位图或图像的规则
QTimeEdit	基于 QDateTimeEdit 控件的用于编辑时间的控件
QToolBar	包含一组控件的可移动面板
QToolBox	带标签的小部件项列
QToolButton	用于命令或选项的快速访问按钮，通常用于 QToolBar 内
QToolTip	适用于任何控件的工具提示（气泡帮助）
QTreeView	树视图的默认模型/视图实现
QTreeWidget	使用预定义树模型的树视图
QTreeWidgetItem	用于 QTreeWidget 便利类的项
QTreeWidgetItemIterator	遍历 QTreeWidget 实例中项的方法
QUndoView	显示 QUndoStack 的内容
QVBoxLayout	将小部件垂直排列
QWhatsThis	对任何小部件的简要描述，即回答“这是什么？”的问题
QWidget	所有用户界面对象的基类
QWidgetAction	通过接口扩展 QAction，以便将自定义小部件插入到基于操作的容器（如工具栏）中
QWidgetItem	代表小部件的布局项
QWizard	向导框架
QWizardPage	向导页面的基类

详细说明

该 Qt Widgets 页面包含有关如何使用该模块的信息。

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