本页内容

Qt GUI C++ Classes

Qt GUI 模块为使用Qt编写的图形化应用程序提供了基本支持。更多内容...

命名空间

QColorConstants

包含 QColor 的预定义常量

类

QAbstractFileIconProvider

QFileSystemModel 类的文件图标

QAbstractTextDocumentLayout

用于为 QTextDocuments 实现自定义布局的抽象基类

QAbstractTextDocumentLayout::PaintContext

QAbstractTextDocumentLayout::PaintContext 类是一个便利类,用于定义绘制文档布局时使用的参数

QAbstractTextDocumentLayout::Selection

QAbstractTextDocumentLayout::Selection 类是一个便利类,用于定义选区的参数

QAccessibilityHints

包含特定于平台的辅助功能提示和设置

QAccessible

与辅助功能相关的枚举和静态函数

QAccessible::State

QAccessibleActionInterface

在界面中实现了对可调用操作的支持

QAccessibleAnnouncementEvent

用于请求辅助技术播报给定消息

QAccessibleAttributesInterface

实现了对可访问对象报告属性的支持

QAccessibleEditableTextInterface

实现了对包含可编辑文本的对象的支持

QAccessibleEvent

无障碍通知的基类

QAccessibleInterface

定义了一个接口,用于公开可访问对象的相关信息

QAccessibleObject

为 QObject 实现 QAccessibleInterface 的一部分

QAccessiblePlugin

为用户界面元素提供无障碍信息的插件的抽象基类

QAccessibleSelectionInterface

实现了对选择处理的支持

QAccessibleStateChangeEvent

向辅助功能框架通知对象状态已发生变化

QAccessibleTableCellInterface

实现了对 IAccessibleTable2 Cell 接口的支持

QAccessibleTableInterface

实现了对 IAccessibleTable2 接口的支持

QAccessibleTableModelChangeEvent

表示表格、列表或树中发生变化,即单元格被添加或删除。如果该变化影响了多行,firstColumn 和 lastColumn 将返回 -1。同样,对于列,行相关函数也可能返回 -1

QAccessibleTextCursorEvent

通知光标移动

QAccessibleTextInsertEvent

通知文本被插入

QAccessibleTextInterface

实现了对文本处理的支持

QAccessibleTextRemoveEvent

通知文本被删除

QAccessibleTextSelectionEvent

指示对象的文本选择发生变化

QAccessibleTextUpdateEvent

通知文本变更。此功能适用于支持可编辑文本的可访问控件,例如行编辑框。例如,当通过粘贴新文本替换部分选定文本,或在编辑器的覆盖模式下,都会触发此事件

QAccessibleValueChangeEvent

描述可访问对象的值发生变化

QAccessibleValueInterface

实现对可操作值的对象的支持

QAccessibleViewportInterface

实现对视口的支持

QAction

可添加到不同用户界面组件中的用户命令的抽象层

QActionEvent

当 QAction 被添加、移除或更改时触发的事件

QActionGroup

将操作分组

QBackingStore

QWindow 的绘图区域

QBitmap

单色(1 位深度)像素图

QBrush

定义由 QPainter 绘制的形状的填充图案

QChildWindowEvent

包含子窗口变化的事件参数

QClipboard

访问窗口系统的剪贴板

QCloseEvent

包含描述关闭事件的参数

QColor

基于 RGB、HSV 或 CMYK 值的颜色

QColorSpace

色彩空间抽象

QColorSpace::PrimaryPoints

该结构体包含四个主色空间点

QColorTransform

颜色空间之间的转换

QConicalGradient

与 QBrush 结合使用,用于指定锥形渐变画笔

QContextMenuEvent

包含描述上下文菜单事件的参数

QCursor

具有任意形状的鼠标光标

QDesktopServices

访问常用桌面服务的方法

QDoubleValidator

浮点数的范围检查

QDrag

支持基于 MIME 的拖放数据传输

QDragEnterEvent

当拖放操作进入某个小部件时,发送到该小部件的事件

QDragLeaveEvent

当拖放操作离开小部件时发送给该小部件的事件

QDragMoveEvent

在拖放操作进行期间发送的事件

QDropEvent

拖放操作完成时发送的事件

QEnterEvent

包含描述进入事件的参数

QEventPoint

关于 QPointerEvent 中某一点的信息

QExposeEvent

包含“暴露”事件的事件参数

QFileOpenEvent

当有请求打开文件或 URL 时将触发的事件

QFileSystemModel

本地文件系统的数据模型

QFocusEvent

包含小部件焦点事件的事件参数

QFont

指定用于绘制文本的字体的查询

QFont::Tag

QFont::Tag 类型可访问高级字体功能

QFontDatabase

关于底层窗口系统中可用字体的信息

QFontInfo

关于字体的通用信息

QFontMetrics

字体度量信息

QFontMetricsF

字体度量信息

QFontVariableAxis

表示字体中的一个可变轴

QGenericMatrix

表示一个 N 列、M 行 N × M 变换矩阵的模板类

QGenericPlugin

插件的抽象基类

QGenericPluginFactory

用于创建插件驱动程序

QGlyphRun

直接访问字体中的内部字形

QGradient

与 QBrush 结合使用以指定渐变填充

QGuiApplication

管理GUI应用程序的控制流和主要设置

QHelpEvent

用于请求有关控件中特定点的有用信息的事件

QHideEvent

控件被隐藏后触发的事件

QHoverEvent

包含描述鼠标事件的参数

QIcon

可在不同模式和状态下缩放的图标

QIconDragEvent

表示主图标的拖动操作已开始

QIconEngine

QIcon 渲染器的抽象基类

QIconEngine::ScaledPixmapArgument

QIconEnginePlugin

自定义 QIconEngine 插件的抽象基类

QImage

一种与硬件无关的图像表示形式,允许直接访问像素数据,并可作为绘图设备使用

QImageIOHandler

定义了 Qt 中所有图像格式的通用图像 I/O 接口

QImageIOPlugin

定义了用于编写图像格式插件的接口

QImageReader

用于从文件或其他设备读取图像的格式无关接口

QImageWriter

用于将图像写入文件或其他设备的、与格式无关的接口

QInputDevice

描述了 QInputEvent 的来源设备

QInputEvent

描述用户输入的事件的基类

QInputMethod

访问当前活动的文本输入法

QInputMethodEvent

输入法事件的参数

QInputMethodEvent::Attribute

QInputMethodEvent::Attribute 类用于存储输入法属性

QInputMethodQueryEvent

由输入上下文发送给输入对象的事件

QIntValidator

用于确保字符串包含指定范围内的有效整数的验证器

QKeyEvent

描述一个键事件

QKeySequence

封装了快捷键中使用的键序列

QLinearGradient

与 QBrush 结合使用,用于指定线性渐变画笔

QMatrix4x4

表示三维空间中的 4x4 变换矩阵

QMouseEvent

包含描述鼠标事件的参数

QMoveEvent

包含移动事件的事件参数

QMovie

用于通过 QImageReader 播放视频的便捷类

QNativeGestureEvent

包含描述手势事件的参数

QNativeInterface::QAndroidOffscreenSurface

Android 系统中用于访问离屏表面的原生接口

QNativeInterface::QAndroidScreen

屏幕的原生接口

QNativeInterface::QCocoaGLContext

macOS 上 NSOpenGLContext 的原生接口

QNativeInterface::QCocoaScreen

macOS 上屏幕的原生接口

QNativeInterface::QEGLContext

EGL 上下文的原生接口

QNativeInterface::QGLXContext

GLX 上下文的原生接口

QNativeInterface::QWGLContext

Windows 系统上 WGL 上下文的原生接口

QNativeInterface::QWaylandApplication

Wayland 应用程序的原生接口

QNativeInterface::QWaylandScreen

Wayland 屏幕的原生接口

QNativeInterface::QWindowsScreen

屏幕的原生接口

QNativeInterface::QX11Application

X11 应用程序的原生接口

QOffscreenSurface

表示底层平台中的离屏表面

QOpenGLContext

表示一个原生 OpenGL 上下文,支持在 QSurface 上进行 OpenGL 渲染

QOpenGLContextGroup

表示一组共享 OpenGL 资源的上下文

QOpenGLExtraFunctions

跨平台访问 OpenGL ES 3.0、3.1 和 3.2 API

QOpenGLFunctions

跨平台访问 OpenGL ES 2.0 API

QOpenGLTexture

封装了一个 OpenGL 纹理对象

QPageLayout

描述页的大小、方向和边距

QPageRanges

表示一组页面范围

QPageRanges::Range

QPageRanges::Range 结构体保存范围的起始点和结束点

QPageSize

描述已定义页面大小的尺寸和名称

QPagedPaintDevice

表示一个支持多页的绘图设备

QPaintDevice

可在其上使用 QPainter 进行绘制的对象的基类

QPaintDeviceWindow

QWindow 的便捷子类,同时也是 QPaintDevice

QPaintEngine

关于 QPainter 如何在给定平台上向给定设备绘制的抽象定义

QPaintEngineState

关于活动绘制引擎当前状态的信息

QPaintEvent

包含绘制事件的事件参数

QPainter

在控件和其他绘图设备上执行低级绘制操作

QPainter::PixmapFragment

该类与 QPainter::drawPixmapFragments() 函数配合使用,用于指定如何绘制位图或位图的子矩形

QPainterPath

绘制操作的容器,支持构建和重用图形形状

QPainterPath::Element

QPainterPath::Element 类指定子路径的位置和类型

QPainterPathStroker

用于为给定的绘制路径生成可填充的轮廓

QPainterStateGuard

用于平衡调用 QPainter::save() 和 QPainter::restore() 的 RAII 便利类

QPalette

包含每个小部件状态的颜色组

QPdfOutputIntent

QPdfWriter

用于生成可作为绘图设备的 PDF 的类

QPen

定义了 QPainter 应如何绘制形状的线段和轮廓

QPicture

用于记录和重放 QPainter 命令的绘图设备

QPixelFormat

用于描述图形缓冲区中不同像素布局的类

QPixmap

可作为绘图设备使用的离屏图像表示形式

QPixmapCache

应用程序范围内的位图缓存

QPixmapCache::Key

QPixmapCache::Key 类可用于高效访问 QPixmapCache

QPlatformSurfaceEvent

用于通知本机平台的表面事件

QPointerEvent

指针事件的基类

QPointingDevice

描述鼠标、触摸或数位板事件的来源设备

QPointingDeviceUniqueId

标识一个与指点设备配合使用的唯一对象,例如带标签的令牌或手写笔

QPolygon

使用整数精度的点列表

QPolygonF

使用浮点精度的点列表

QQuaternion

表示由一个向量和一个标量组成的四元数

QQuaternion::Axes

QQuaternion::Axis

QQuaternion::EulerAngles

QRadialGradient

与 QBrush 配合使用,用于指定径向渐变画笔

QRasterWindow

用于在 QWindow 上使用 QPainter 的便捷类

QRawFont

访问字体的单个物理实例

QRegion

为绘图器指定裁剪区域

QRegularExpressionValidator

用于检查字符串是否符合正则表达式

QResizeEvent

包含调整大小事件的事件参数

QRgba64

该结构体包含一个 64 位 RGB 颜色

QRgbaFloat

该结构体包含一个由四部分组成的 RGBA 浮点颜色

QRhiVulkanQueueSubmitParams

引用了传递给 vkQueueSubmit() 的其他 Vulkan API 对象

QScreen

用于查询屏幕属性

QScrollEvent

在滚动时发送

QScrollPrepareEvent

在准备滚动时发送

QSessionManager

访问会话管理器

QShader

包含已转换为多种着色语言的着色器多个版本,以及反射元数据

QShader::NativeShaderInfo

关于原生着色器代码的附加元数据

QShader::SeparateToCombinedImageSamplerMapping

采样器统一变量的映射元数据

QShaderCode

包含着色器的源代码或二进制代码以及附加元数据

QShaderDescription

描述着一个着色器的接口

QShaderDescription::BlockVariable

描述统一变量或推送常量块中的一个成员

QShaderDescription::BuiltinVariable

描述内置变量

QShaderDescription::InOutVariable

描述着着色器中的输入或输出变量

QShaderDescription::PushConstantBlock

描述一个 push 常量块

QShaderDescription::StorageBlock

描述着一个着色器存储块

QShaderDescription::UniformBlock

描述一个uniform块

QShaderKey

指定着色语言、带标志的版本以及变体

QShaderVersion

指定着色语言的版本

QShortcut

用于创建键盘快捷键

QShortcutEvent

当用户按下组合键时触发的事件

QShowEvent

当小部件显示时发送的事件

QSinglePointEvent

用于包含单个点的指针事件(如鼠标事件)的基类

QStandardItem

用于与 QStandardItemModel 类配合使用的项

QStandardItemModel

用于存储自定义数据的通用模型

QStaticText

当文本及其布局很少更新时,可实现文本的优化绘制

QStatusTipEvent

用于在状态栏中显示消息的事件

QStyleHints

包含特定于平台的提示和设置

QSupportedWritingSystems

用于将字体注册到 Qt 内部字体数据库时

QSurface

Qt 中可渲染表面的抽象表示

QSurfaceFormat

表示 QSurface 的格式

QSyntaxHighlighter

允许您定义语法高亮规则,此外,您还可以使用该类查询文档的当前格式或用户数据

QTabletEvent

包含描述平板电脑事件的参数

QTextBlock

QTextDocument 中文本片段的容器

QTextBlock::iterator

QTextBlock::iterator 类提供了一个迭代器,用于读取 QTextBlock 的内容

QTextBlockFormat

QTextDocument 中文本块的格式信息

QTextBlockGroup

QTextDocument 中的文本块容器

QTextBlockUserData

用于将自定义数据与文本块关联

QTextCharFormat

QTextDocument 中字符的格式信息

QTextCursor

提供用于访问和修改 QTextDocument 的 API

QTextDocument

用于存储格式化后的文本

QTextDocumentFragment

表示来自 QTextDocument 的一个格式化文本片段

QTextDocumentWriter

用于将 QTextDocument 写入文件或其他设备的与格式无关的接口

QTextFormat

QTextDocument 的格式化信息

QTextFragment

在 QTextDocument 中存储一段带有单个 QTextCharFormat 的文本

QTextFrame

表示 QTextDocument 中的一个框架

QTextFrameFormat

QTextDocument 中框架的格式化信息

QTextImageFormat

QTextDocument 中图像的格式化信息

QTextInlineObject

表示 QAbstractTextDocumentLayout 及其实现中的内联对象

QTextItem

在自定义绘制引擎中绘制文本所需的所有信息

QTextLayout

用于文本的排版和渲染

QTextLayout::FormatRange

QTextLayout::FormatRange 结构用于对文本布局内容中的指定区域应用额外的格式化信息

QTextLength

封装了 QTextDocument 中使用的不同类型长度

QTextLine

表示 QTextLayout 中的文本行

QTextList

QTextDocument 中带装饰效果的项目列表

QTextListFormat

QTextDocument 中列表的格式化信息

QTextObject

可将 QTextDocument 的各个部分分组在一起的各类对象的基类

QTextObjectInterface

允许在 QTextDocument 中绘制自定义文本对象

QTextOption

关于一般富文本属性的描述

QTextOption::Tab

QTextTable

表示 QTextDocument 中的表格

QTextTableCell

表示 QTextTable 中单元格的属性

QTextTableCellFormat

QTextDocument 中表格单元格的格式设置信息

QTextTableFormat

QTextDocument 中表格的格式设置信息

QTouchEvent

包含描述触摸事件的参数

QTransform

指定坐标系的二维变换

QUndoCommand

存储在 QUndoStack 中的所有命令的基类

QUndoGroup

QUndoStack 对象的组

QUndoStack

QUndoCommand 对象的栈

QUtiMimeConverter

在 MIME 类型与统一类型标识符(UTI)格式之间进行转换

QValidator

输入文本的验证

QVector2D

表示二维空间中的向量或顶点

QVector3D

表示三维空间中的向量或顶点

QVector4D

表示 4D 空间中的向量或顶点

QVulkanDeviceFunctions

跨平台访问设备级核心 Vulkan 1.3 API

QVulkanExtension

表示有关 Vulkan 扩展的信息

QVulkanFunctions

跨平台访问实例级核心 Vulkan 1.3 API

QVulkanInfoVector

专为 QVulkanLayer 和 QVulkanExtension 设计的 QList

QVulkanInstance

表示一个原生 Vulkan 实例,支持在 QSurface 上进行 Vulkan 渲染

QVulkanLayer

表示有关 Vulkan 层的信息

QVulkanWindow

QWindow 的便捷子类,用于执行 Vulkan 渲染

QVulkanWindowRenderer

用于为 QVulkanWindow 实现应用程序特有的渲染逻辑

QWhatsThisClickedEvent

可用于处理“这是什么?”文本中超链接的事件

QWheelEvent

包含描述滚轮事件的参数

QWindow

表示底层窗口系统中的一个窗口

QWindowStateChangeEvent

窗口状态发生变化前的状态

QWindowsMimeConverter

将开放标准的 MIME 格式映射到 Window Clipboard 格式

详细说明

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

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