本页内容

Qt Core C++ Classes

提供核心的非GUI功能。更多内容...

命名空间

Qt

包含 Qt 库中各处使用的各类标识符

Qt::Literals

内联命名空间为 Qt 类型声明字面量运算符

Qt::Literals::StringLiterals

为 Qt 字符串类型声明字面量运算符

QtFuture

包含 QFuture 类所使用的各种标识符

QtJniTypes

声明与 Java 类型对应的 C++ 类型

QtLiterals

声明了 Qt 类型的字面量运算符

类

QAbstractAnimation

所有动画的基础

QAbstractEventDispatcher

用于管理 Qt 事件队列的接口

QAbstractEventDispatcher::TimerInfoV2

QAbstractEventDispatcherV2

QAbstractItemModel

项目模型类的抽象接口

QAbstractListModel

可通过继承创建一维列表模型的抽象模型

QAbstractNativeEventFilter

用于接收原生事件(如 MSG 或 XCB 事件结构体)的接口

QAbstractProxyModel

用于代理项模型的基类,可执行排序、过滤或其他数据处理任务

QAbstractTableModel

可通过继承创建表格模型的抽象模型

QAdoptSharedDataTag

辅助标签类

QAnimationGroup

动画组的抽象基类

QAnyStringView

针对 Latin-1、UTF-8 或 UTF-16 字符串的统一视图,包含 QString API 的只读子集

QAssociativeIterable

用于 QVariant 中关联容器的可迭代接口

QAtomicInt

针对 int 的平台无关原子操作

QAtomicInteger

针对整数的跨平台原子操作

QAtomicPointer

提供针对指针的跨平台原子操作的模板类

QAtomicScopedValueRollback

为原子变量提供 QScopedValueRollback

QBEInteger

平台无关的大端序整数

QBaseIterator

QBasicTimer

对象的定时器事件

QBindable

围绕支持绑定的属性的封装类。它允许进行类型安全的操作,同时抽象掉了各种属性类之间的差异

QBitArray

位数组

QBluetoothPermission

访问蓝牙外设

QBuffer

用于 QByteArray 的 QIODevice 接口

QByteArray

字节数组

QByteArray::FromBase64Result

QByteArray::FromBase64Result 类用于存储调用 QByteArray::fromBase64Encoding 后的结果

QByteArrayList

字节数组列表

QByteArrayMatcher

包含一串字节,可在字节数组中快速匹配

QByteArrayView

对字节数组的视图,提供 QByteArray API 的只读子集

QCache

提供缓存功能的模板类

QCalendar

描述日历系统

QCalendar::SystemId

QCalendarPermission

访问用户的日历

QCameraPermission

访问相机以拍摄照片或视频

QCborArray

用于存储 CBOR 元素数组

QCborError

用于存储在解析或验证 CBOR 流时发现的错误情况

QCborMap

用于存储可在 CBOR 中表示的关联容器

QCborMap::ConstIterator

QCborMap::ConstIterator 类为 QCborMap 提供了一个 STL 风格的 const 迭代器

QCborMap::Iterator

QCborMap::Iterator 类为 QCborMap 提供了一个 STL 风格的非 const 迭代器

QCborParserError

由 QCborValue 用于报告解析错误

QCborStreamReader

简单的 CBOR 流解码器,可操作 QByteArray 或 QIODevice

QCborStreamReader::StringResult

QCborStreamWriter

简单的 CBOR 编码器,可在单向流上运行

QCborValue

将值封装为 CBOR 格式

QChar

16 位 Unicode 字符

QChildEvent

包含子对象事件的事件参数

QChronoTimer

重复和单次定时器

QCollator

根据本地化的排序算法比较字符串

QCollatorSortKey

可用于加快字符串排序速度

QCommandLineOption

定义了一个可能的命令行选项

QCommandLineParser

处理命令行选项的方法

QConcatenateTablesProxyModel

代理多个源模型,并将它们的行拼接起来

QConstIterator

允许在 QVariant 中对容器进行迭代

QContactsPermission

访问用户的联系人

QContiguousCache

提供连续缓存的模板类

QCoreApplication

用于无用户界面的 Qt 应用程序的事件循环

QCryptographicHash

生成加密哈希值的方法

QDataStream

将二进制数据序列化到 QIODevice

QDate

日期函数

QDateTime

日期和时间函数

QDeadlineTimer

标记未来的截止时间

QDebug

用于调试信息的输出流

QDebugStateSaver

用于自定义 QDebug 运算符的便捷类

QDir

访问目录结构及其内容

QDirIterator

用于目录条目列表的迭代器

QDirListing

用于目录条目的 STL 风格迭代器

QDirListing::DirEntry

QDirListing::sentinel

QDynamicPropertyChangeEvent

包含动态属性更改事件的事件参数

QEasingCurve

用于控制动画的缓动曲线

QElapsedTimer

计算经过时间的快速方法

QEnableSharedFromThis

一个基类,允许获取由共享指针已管理的对象的 QSharedPointer

QEvent

所有事件类的基类。事件对象包含事件参数

QEventLoop

进入和退出事件循环的机制

QEventLoopLocker

当不再需要事件循环时退出事件循环的方法

QException

可在线程间传递的异常的基类

QExplicitlySharedDataPointer

表示对显式共享对象的指针

QFile

用于从文件读取和向文件写入的接口

QFileDevice

用于从已打开文件中读写数据的接口

QFileInfo

用于检索文件系统条目信息的操作系统独立 API

QFileSelector

选择文件变体的便捷方法

QFileSystemWatcher

用于监视文件和目录是否发生修改的接口

QFlag

用于 QFlags 的辅助数据类型

QFlags

以类型安全的方式存储枚举值的“或”组合

QFuture

表示异步计算的结果

QFutureIterator

用于 QFuture 的 Java 风格 const 迭代器

QFutureSynchronizer

用于简化 QFuture 同步的便捷类

QFutureWatcher

允许使用信号和槽来监视 QFuture

QGenericArgument

用于参数序列化的内部辅助类

QGenericReturnArgument

用于序列化参数的内部辅助类

QGlobalStatic

用于实现全局静态对象

QHash

提供基于哈希表的字典的模板类

QHash::TryEmplaceResult

用于表示 tryEmplace() 操作的结果

QHashIterator

用于 QHash 和 QMultiHash 的 Java 风格 const 迭代器

QHashSeed

QIODevice

Qt 中所有 I/O 设备的基接口类

QIODeviceBase

QIODevice 的基类,提供描述设备打开模式的标志

QIdentityProxyModel

原样代理其源模型

QItemSelection

管理模型中已选项目的的相关信息

QItemSelectionModel

跟踪视图中选中的项目

QItemSelectionRange

管理模型中选定项目范围的相关信息

QIterable

作为 QMetaSequence::Iterable 和 QMetaAssociation::Iterable 基类的模板类

QIterator

允许对 QVariant 中的容器进行迭代的模板类

QJniArray

表示 Java 中数组的模板类

QJniArrayBase

QJniArray 的通用、与类型无关的 API

QJniEnvironment

访问 JNI 环境 (JNIEnv)

QJniObject

围绕 Java 本机接口 (JNI) 构建的便捷封装类

QJsonArray

封装了一个 JSON 数组

QJsonDocument

读写 JSON 文档的方法

QJsonObject

封装 JSON 对象

QJsonParseError

用于报告 JSON 解析过程中的错误

QJsonValue

封装 JSON 中的值

QKeyCombination

存储由键和可选修饰符组成的组合

QKeyValueIterator

遍历关联容器中键值对的迭代器

QLEInteger

与平台无关的小端整数

QLatin1Char

8 位 ASCII/Latin-1 字符

QLatin1String

与 QLatin1StringView 相同

QLatin1StringMatcher

针对 Latin-1 文本的子字符串优化搜索

QLatin1StringView

针对 US-ASCII/Latin-1 编码字符串字面量的轻量级封装

QLibrary

在运行时加载共享库

QLibraryInfo

关于 Qt 库的信息

QLine

使用整数精度的二维向量

QLineF

使用浮点精度的二维向量

QList

提供动态数组的模板类

QListIterator

适用于 QList 和 QQueue 的 Java 风格 const 迭代器

QLocale

在各种语言中实现数字与其字符串表示形式之间的转换

QLocationPermission

获取用户的地理位置

QLockFile

使用文件实现进程间的锁定

QLoggingCategory

表示日志记录基础设施中的一个类别或“区域”

QMap

提供关联数组的模板类

QMapIterator

用于 QMap 的 Java 风格常量迭代器

QMargins

定义矩形的四个边距

QMarginsF

定义矩形的四个边距

QMessageAuthenticationCode

生成基于哈希的消息认证码的方法

QMessageLogContext

关于日志消息的附加信息

QMessageLogger

生成日志消息

QMetaAssociation

允许以类型擦除的方式访问关联容器

QMetaClassInfo

关于类的附加信息

QMetaContainer

顺序容器和关联容器的通用功能

QMetaEnum

关于枚举器的元数据

QMetaMethod

关于成员函数的元数据

QMetaObject

包含关于 Qt 对象的元信息

QMetaObject::Connection

QMetaProperty

关于属性的元数据

QMetaSequence

允许以类型擦除的方式访问顺序容器

QMetaSequence::Iterable

QMetaSequence::Iterable 类是 QVariant 中容器的可迭代接口

QMetaType

在元对象系统中管理命名类型

QMicrophonePermission

访问麦克风以监听或录制声音

QMimeData

用于记录其 MIME 类型信息的容器

QMimeDatabase

维护 MIME 类型数据库

QMimeType

描述由 MIME 类型字符串表示的文件或数据类型

QModelIndex

用于在数据模型中定位数据

QModelRoleData

包含一个角色及其关联的数据

QModelRoleDataSpan

跨越 QModelRoleData 对象的范围

QMultiHash

多值哈希表

QMultiMap

提供具有多个等效键的关联数组的模板类

QMultiMap::key_iterator

QMultiMap::key_iterator 类为 QMultiMap 的键提供了一个 STL 风格的 const 迭代器

QMultiMapIterator

QMultiMap 的 Java 风格 const 迭代器。QMultiMap 同时支持 Java 风格迭代器和 STL 风格迭代器。STL 风格迭代器效率更高,应优先使用。模板参数 Key 指定映射的键类型,T 指定值类型

QMutableHashIterator

用于 QHash 和 QMultiHash 的 Java 风格非 const 迭代器

QMutableListIterator

适用于 QList、QQueue 和 QStack 的 Java 风格非 const 迭代器

QMutableMapIterator

适用于 QMap 的 Java 风格非 const 迭代器

QMutableMultiMapIterator

QMultiMap 的 Java 风格非 const 迭代器

QMutableSetIterator

适用于 QSet 的 Java 风格非 const 迭代器

QMutex

线程间访问序列化

QMutexLocker

用于简化互斥锁加锁和解锁操作的便捷类

QNativeInterface::QAndroidApplication

Android 核心应用程序的原生接口

QNativeIpcKey

持有 QSystemSemaphore 和 QSharedMemory 所使用的原生键

QNtfsPermissionCheckGuard

用于管理 NTFS 权限检查的 RAII 类

QObject

所有 Qt 对象的基类

QObjectBindableProperty

支持为 QObject 派生类中存储的属性数据进行自动属性绑定的模板类

QObjectCleanupHandler

监视多个 QObject 的生命周期

QObjectComputedProperty

用于帮助将旧属性移植到可绑定属性系统的模板类

QOperatingSystemVersion

有关操作系统版本的信息

QParallelAnimationGroup

并行动画组

QPartialOrdering

表示允许结果无序的比较结果

QPauseAnimation

用于 QSequentialAnimationGroup 的暂停功能

QPermission

类型化权限的不透明封装器

QPersistentModelIndex

用于在数据模型中定位数据

QPluginLoader

在运行时加载插件

QPoint

使用整数精度在平面上定义一个点

QPointF

使用浮点精度在平面上定义一个点

QPointer

提供指向 QObject 的受保护指针的模板类

QProcess

用于启动外部程序并与之通信

QProcess::CreateProcessArguments

QProcess::UnixProcessParameters

QProcessEnvironment

保存可传递给程序的环境变量

QPromise

将计算结果存储起来以便 QFuture 访问的方法

QProperty

支持自动属性绑定的模板类

QPropertyAnimation

对 Qt 属性进行动画处理

QPropertyBindingError

QPropertyChangeHandler

控制安装在 QProperty 上的变更回调的生命周期

QPropertyData

用于具有自动属性绑定的属性的辅助类

QPropertyNotifier

控制安装在 QProperty 上的变更回调的生命周期

QQueue

提供队列功能的通用容器

QRandomGenerator

允许从高质量的随机数生成器中获取随机值

QRandomGenerator64

允许从高质量、无种子随机数生成器中获取 64 位随机值

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

QReadLocker

用于简化读写锁的加锁和解锁操作,以便进行读取访问的便捷类

QReadWriteLock

读写锁定

QRect

使用整数精度在平面上定义一个矩形

QRectF

使用浮点精度在平面上定义一个有限矩形

QRecursiveMutex

线程间的访问序列化

QRegularExpression

使用正则表达式进行模式匹配

QRegularExpressionMatch

将 QRegularExpression 与字符串进行匹配的结果

QRegularExpressionMatchIterator

QRegularExpression 对象对字符串进行全局匹配的结果迭代器

QResource

直接从资源中读取数据的接口

QRunnable

所有可运行对象的基类

QSaveFile

用于安全写入文件的接口

QScopeGuard

提供用于在作用域末尾调用函数的作用域保护机制

QScopedArrayPointer

存储指向动态分配的对象数组的指针,并在销毁时将其删除

QScopedPointer

存储指向动态分配对象的指针,并在销毁时将其删除

QScopedPropertyUpdateGroup

围绕 Qt::beginPropertyUpdateGroup()/Qt::endPropertyUpdateGroup() 实现的 RAII 类

QScopedValueRollback

在销毁时将变量重置为先前值

QSemaphore

通用计数信号量

QSemaphoreReleaser

对 QSemaphore::release() 调用的异常安全延迟执行

QSequentialAnimationGroup

动画的顺序组

QSequentialIterable

QVariant 中容器的可迭代接口

QSet

提供基于哈希表的集合的模板类

QSet::const_iterator

QSet::const_iterator 类为 QSet 提供了一个 STL 风格的 const 迭代器

QSet::iterator

QSet::iterator 类为 QSet 提供了一个 STL 风格的非 const 迭代器

QSetIterator

QSet 的 Java 风格 const 迭代器

QSettings

持久的、与平台无关的应用程序设置

QSharedData

共享数据对象的基类

QSharedDataPointer

表示对隐式共享对象的指针

QSharedMemory

访问共享内存段

QSharedPointer

持有对共享指针的强引用

QSignalBlocker

围绕 QObject::blockSignals() 的异常安全封装

QSignalMapper

将来自可识别发送者的信号打包在一起

QSize

使用整数点精度定义二维对象的大小

QSizeF

使用浮点精度定义二维对象的大小

QSocketNotifier

支持监视文件描述符上的活动

QSortFilterProxyModel

支持对另一个模型与视图之间传递的数据进行排序和过滤

QSpan

用于连续数据的非拥有型容器

QStack

提供栈功能的模板类

QStandardPaths

用于访问标准路径的方法

QStaticByteArrayMatcher

QByteArrayMatcher 的编译时版本

QStaticLatin1StringMatcher

QLatin1StringMatcher 的编译时版本

QStaticPlugin

包含对静态插件实例及其元数据引用的结构体

QStorageInfo

提供有关当前已挂载存储设备和驱动器的信息

QString

Unicode 字符串

QStringConverter

文本编码和解码的基类

QStringConverter::FinalizeResultChar

保存对 QStringDecoder 或 QStringEncoder 调用 finalize() 后的结果

QStringDecoder

基于状态的文本解码器

QStringEncoder

基于状态的文本编码器

QStringList

字符串列表

QStringListModel

向视图提供字符串的模型

QStringMatcher

保存一串字符,可在 Unicode 字符串中快速进行匹配

QStringTokenizer

根据给定的分隔符将字符串拆分为令牌

QStringView

针对 UTF-16 字符串的统一视图,包含 QString API 的只读子集

QSysInfo

系统信息

QSystemSemaphore

通用计数系统信号量

QTaggedIterator

封装迭代器并暴露标准迭代器特性的模板类

QTemporaryDir

创建一个用于临时使用的唯一目录

QTemporaryFile

操作临时文件的 I/O 设备

QTextBoundaryFinder

在字符串中查找 Unicode 文本边界的方法

QTextStream

用于读写文本的便捷接口

QThread

一种平台独立的线程管理方式

QThreadPool

管理一组 QThread 对象

QThreadStorage

按线程的数据存储

QTime

时钟时间函数

QTimeLine

用于控制动画的时间轴

QTimeZone

确定时间表示与协调世界时(UTC)之间的关系

QTimeZone::OffsetData

QTimer

循环定时器和单次定时器

QTimerEvent

包含描述定时器事件的参数

QTranslator

对文本输出的国际化支持

QTransposeProxyModel

此代理对源模型进行转置

QTypeRevision

包含一个版本号的轻量级表示形式,由两个 8 位段(主版本号和次版本号)组成,其中任一者均可为未知

QUnhandledException

表示Qt Concurrent 工作线程中未处理的异常

QUntypedBindable

针对任何类型 T 的 QProperty\<T\> 和 QObjectBindableProperty 等可绑定属性的统一接口

QUntypedPropertyBinding

表示类型擦除的属性绑定

QUrl

用于处理 URL 的便捷接口

QUrlQuery

操作 URL 查询字符串中键值对的方法

QUtf8StringView

针对 UTF-8 字符串的统一视图,包含 QString API 的只读子集

QUuid

用于存储通用唯一标识符(UUID)

QUuid::Id128Bytes

QVarLengthArray

低级可变长度数组

QVariant

行为类似于最常见的 Qt 数据类型的联合体

QVariant::ConstPointer

QVariant::ConstPointer 是一个模板类,用于模拟指向 QVariant 的 const 指针

QVariant::ConstReference

QVariant::ConstReference 充当指向 QVariant 的 const 引用

QVariant::Pointer

QVariant::Pointer 是一个模板类,用于模拟指向 QVariant 的非 const 指针

QVariant::Reference

QVariant::Reference 充当指向 QVariant 的非 const 引用

QVariantAnimation

动画的基类

QVariantConstPointer

基于指针模拟的指向 QVariant 的 const 指针

QVariantPointer

基于指针模拟 QVariant 指针的模板类

QVariantRef

充当对 QVariant 的非 const 引用

QVector

QList 的别名

QVersionNumber

包含一个由任意数量段组成的版本号

QWaitCondition

用于线程同步的条件变量

QWeakPointer

持有对共享指针的弱引用

QWinEventNotifier

支持 Windows 的 Wait 函数

QWriteLocker

用于简化读写锁的加锁和解锁操作的便捷类(用于写入访问)

QXmlStreamAttribute

表示单个 XML 属性

QXmlStreamAttributes

表示一个 QXmlStreamAttribute 向量

QXmlStreamEntityDeclaration

表示一个 DTD 实体声明

QXmlStreamEntityResolver

QXmlStreamReader 的实体解析器

QXmlStreamNamespaceDeclaration

表示命名空间声明

QXmlStreamNotationDeclaration

表示 DTD 标记法声明

QXmlStreamReader

通过简单的流式API读取结构良好的XML 1.0文档的高速解析器

QXmlStreamWriter

带简单流式 API 的 XML 1.0 写入器

Qt::has_qt_compare_three_way

用于检查类型是否支持 compareThreeWay() 的类型特质

Qt::partial_ordering

Qt::partial_ordering 表示允许结果无特定顺序的比较结果

Qt::strong_ordering

Qt::strong_ordering 表示一种比较,其中等价的值无法区分

Qt::totally_ordered_wrapper

Qt::totally_ordered_wrapper 是一种包装类型,为被包装的类型提供严格的完全序

Qt::weak_ordering

Qt::weak_ordering 表示一种比较,其中等价值仍然可以区分

QtFuture::WhenAnyResult

QtFuture::WhenAnyResult 用于表示 QtFuture::whenAny() 的结果

QtJniTypes::JObject

QtJniTypes 命名空间中的模板是已声明 Java 类型的基类

qfloat16

提供 16 位浮点数支持

详细说明

所有其他 Qt 模块都依赖于此模块。

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

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