Qt 6.12 中的新类和函数

本页面包含 Qt 6.12 中引入的所有新类和函数的完整列表。

新类

新成员职能

Q3DGraphsWidgetItem 类:

(since 6.12) void setPanButton(Qt::MouseButtons button)

QAbstractItemModel 类:

(since 6.12) Qt::weak_ordering compareData(const QVariant &left, const QVariant &right)
(since 6.12) Qt::weak_ordering compareData(const QVariant &left, const QVariant &right, const QCollator &collator)

QAccessibleInterface 类:

(since 6.12) QAccessibleViewportInterface *viewportInterface()

QAudioSink 类:

(since 6.12) qsizetype nativePeriodFrameCount() const
(since 6.12) void setNativePeriodFrameCount(qsizetype frameCount)

QAudioSource 类:

(since 6.12) qsizetype nativePeriodFrameCount() const
(since 6.12) void setNativePeriodFrameCount(qsizetype frameCount)

QCanvasGradient 类:

(since 6.12) void addColorStop(qreal position, QColor color)
(since 6.12) void setImage(const QCanvasImage &image, int index = 0)

QCanvasPainter 类:

(since 6.12) void fill(QCanvasPainter::FillRule fillRule)
(since 6.12) void fill(const QCanvasPath &path, QCanvasPainter::FillRule fillRule, int pathGroup = -1)
(since 6.12) void setFillRule(QCanvasPainter::FillRule fillRule)

QCanvasPath 类:

(since 6.12) void addPath(QStringView svgPath, const QTransform &transform = QTransform())

QCanvasRadialGradient 类:

(since 6.12) QPointF innerCenterPosition() const
(since 6.12) QPointF outerCenterPosition() const
(since 6.12) void setInnerCenterPosition(qreal x, qreal y)
(since 6.12) void setInnerCenterPosition(QPointF center)
(since 6.12) void setOuterCenterPosition(qreal x, qreal y)
(since 6.12) void setOuterCenterPosition(QPointF center)

QCollator 类:

(since 6.12) bool operator!=(const QCollator &lhs, const QCollator &rhs)
(since 6.12) bool operator==(const QCollator &lhs, const QCollator &rhs)

QCollatorSortKey 类:

(since 6.12) bool operator!=(const QCollatorSortKey &lhs, const QCollatorSortKey &rhs)
(since 6.12) bool operator<(const QCollatorSortKey &lhs, const QCollatorSortKey &rhs)
(since 6.12) bool operator<=(const QCollatorSortKey &lhs, const QCollatorSortKey &rhs)
(since 6.12) bool operator==(const QCollatorSortKey &lhs, const QCollatorSortKey &rhs)
(since 6.12) bool operator>(const QCollatorSortKey &lhs, const QCollatorSortKey &rhs)
(since 6.12) bool operator>=(const QCollatorSortKey &lhs, const QCollatorSortKey &rhs)

QDialogButtonBox 类:

(since 6.12) QKeySequence standardButtonShortcut(QDialogButtonBox::StandardButton button)
(since 6.12) QString standardButtonText(QDialogButtonBox::StandardButton button)

QEasingCurve 类:

(since 6.12) QEasingCurve fromCubicBezier(QPointF c1, QPointF c2)

QGrpcCallOptions 类:

(since 6.12) std::optional<quint64> maximumReceiveMessageSize() const
(since 6.12) std::optional<QtGrpc::CompressionAlgorithm> requestCompression() const
(since 6.12) QGrpcCallOptions &setMaximumReceiveMessageSize(quint64 size)
(since 6.12) QGrpcCallOptions &setRequestCompression(QtGrpc::CompressionAlgorithm algorithm)

QGrpcChannelOptions 类:

(since 6.12) QtGrpc::CompressionAlgorithms acceptedCompressionAlgorithms() const
(since 6.12) std::optional<quint64> maximumReceiveMessageSize() const
(since 6.12) std::optional<QtGrpc::CompressionAlgorithm> requestCompression() const
(since 6.12) QGrpcChannelOptions &setAcceptedCompressionAlgorithms(QtGrpc::CompressionAlgorithms algorithms)
(since 6.12) QGrpcChannelOptions &setMaximumReceiveMessageSize(quint64 size)
(since 6.12) QGrpcChannelOptions &setRequestCompression(QtGrpc::CompressionAlgorithm algorithm)
(since 6.12) QtGrpc::CompressionAlgorithms supportedCompressionAlgorithms()

QHash 类:

(since 6.12) size_t qHash(const std::optional<T> &key, size_t seed = 0)

QHostInfo 类:

(since 6.12) void clearCache()

QHttpHeaderRangeSet 类:

(since 6.12) QDebug operator<<(QDebug debug, const QHttpHeaderRangeSet &ranges)

QHttpHeaderRangeSpec 类:

(since 6.12) QDebug operator<<(QDebug debug, const QHttpHeaderRangeSpec &range)
(since 6.12) size_t qHash(QHttpHeaderRangeSpec key, size_t seed = 0)

QHttpHeaders 类:

(since 6.12) QDataStream &operator<<(QDataStream &out, const QHttpHeaders &headers)
(since 6.12) QDataStream &operator>>(QDataStream &in, QHttpHeaders &headers)
(since 6.12) std::optional<QHttpHeaderRangeSet> rangeValues() const
(since 6.12) void setRangeValues(const QHttpHeaderRangeSet &ranges)

QHttpServerConfiguration 类:

(since 6.12) quint32 maximumConnections() const
(since 6.12) quint32 maximumConnectionsPerHost() const
(since 6.12) void setMaximumConnections(quint32 maxConnections)
(since 6.12) void setMaximumConnectionsPerHost(quint32 maxPerHost)

QImageReader 类:

(since 6.12) QSize effectiveSize() const

QJsonObject 类:

(since 6.12) QJsonObject::const_iterator cbegin() const
(since 6.12) QJsonObject::const_iterator cend() const

QMap 类:

(since 6.12) bool operator<(const QMap<Key, T> &lhs, const QMap<Key, T> &rhs)
(since 6.12) bool operator<=(const QMap<Key, T> &lhs, const QMap<Key, T> &rhs)
(since 6.12) auto operator<=>(const QMap<Key, T> &lhs, const QMap<Key, T> &rhs)
(since 6.12) bool operator>(const QMap<Key, T> &lhs, const QMap<Key, T> &rhs)
(since 6.12) bool operator>=(const QMap<Key, T> &lhs, const QMap<Key, T> &rhs)

QMultiMap 类:

(since 6.12) bool operator<(const QMultiMap<Key, T> &lhs, const QMultiMap<Key, T> &rhs)
(since 6.12) bool operator<=(const QMultiMap<Key, T> &lhs, const QMultiMap<Key, T> &rhs)
(since 6.12) auto operator<=>(const QMultiMap<Key, T> &lhs, const QMultiMap<Key, T> &rhs)
(since 6.12) bool operator>(const QMultiMap<Key, T> &lhs, const QMultiMap<Key, T> &rhs)
(since 6.12) bool operator>=(const QMultiMap<Key, T> &lhs, const QMultiMap<Key, T> &rhs)

QObject 类:

(since 6.12) bool disconnect(QMetaObject::Connection &connection)
(since 6.12) bool disconnect(QMetaObject::Connection &&connection)

QQmlEngine 类:

(since 6.12) bool setExternalSingletonInstance(QAnyStringView moduleName, QAnyStringView typeName, QObject *instance)

SourceLocation 类:

(since 6.12) QQmlSA::SourceLocation documentOrigin()

QQuick3DTextureProviderExtension 类:

(since 6.12) void surfaceChanged()

ItemAccess 类:

(since 6.12) bool canDropMimeData(const QMimeData *data)
(since 6.12) bool canDropMimeData(const QMimeData *data, int action, int row, int column, const QModelIndex &parent)
(since 6.12) auto dropMimeData(const QMimeData *data, auto inserter)
(since 6.12) auto dropMimeData(const QMimeData *data, int action, int row, int column, const QModelIndex &parent, auto inserter)
(since 6.12) Qt::ItemFlags flags(const T &item)
(since 6.12) QMimeData *mimeData(const QModelIndex &range)
(since 6.12) QMimeData *mimeData(const auto &range)
(since 6.12) QStringList mimeTypes()

RowOptions 类:

(since 6.12) bool canDropMimeData(const QMimeData*data)
(since 6.12) bool canDropMimeData(const QMimeData*data, intaction, introw, intcolumn, const QModelIndex&parent)
(since 6.12) auto dropMimeData(const QMimeData*data, autoinserter)
(since 6.12) auto dropMimeData(const QMimeData*data, intaction, introw, intcolumn, const QModelIndex&parent, autoinserter)
(since 6.12) Qt::ItemFlags flags(const T&row)
(since 6.12) QVariant headerData(intsection, introle)
(since 6.12) QMimeData *mimeData(const QModelIndex&range)
(since 6.12) QMimeData *mimeData(const auto&range)
(since 6.12) QStringList mimeTypes()

类QRangeModelAdapter :

(since 6.12) auto at(const QModelIndex &index)
(since 6.12) auto at(const QModelIndex &index) const
(since 6.12) QVariant data(const QModelIndex &index) const
(since 6.12) QVariant data(const QModelIndex &index, int role) const
(since 6.12) bool hasChildren(const QModelIndex &index) const
(since 6.12) int rowCount(const QModelIndex &index) const
(since 6.12) bool setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole)

类QRemoteObjectNode :

(since 6.12) void persistedStoreChanged(QRemoteObjectAbstractPersistedStore *persistedStore)
(since 6.12) void registryUrlChanged(const QUrl &registryUrl)

类QRhiCommandBuffer :

(since 6.12) void drawIndexedIndirect(QRhiBuffer *indirectBuffer, quint32 indirectBufferOffset, quint32 drawCount, quint32 stride = sizeof(QRhiIndexedIndirectDrawCommand))
(since 6.12) void drawIndirect(QRhiBuffer *indirectBuffer, quint32 indirectBufferOffset, quint32 drawCount, quint32 stride = sizeof(QRhiIndirectDrawCommand))

QRhiTextureRenderTargetDescription 类:

(since 6.12) int depthLayer() const
(since 6.12) void setDepthLayer(int depthLayer)

类QSaveFile :

(since 6.12) virtual QFileDevice::Permissions permissions() const override
(since 6.12) virtual bool setPermissions(QFileDevice::Permissions permissions) override

QSet 类:

(since 6.12) QSet<T>::iterator insert(QSet<T>::const_iterator it, T &&value)
(since 6.12) QList<T> values() &&

QShaderVersion 类:

(since 6.12) size_t qHash(QShaderVersion key, size_t seed)

QSharedPointer 类:

(since 6.12) QSharedPointer<X> qSharedPointerStaticCast(const QSharedPointer<T> &other)
(since 6.12) QSharedPointer<X> qSharedPointerStaticCast(const QWeakPointer<T> &other)
(since 6.12) QSharedPointer<X> qSharedPointerStaticCast(QSharedPointer<T> &&other)

QSortFilterProxyModel 类:

(since 6.12) QSortFilterProxyModel::DataChangeRelevanceFlags dataChangeRelevanceFlags(const QModelIndex &sourceTopLeft, const QModelIndex &sourceBottomRight, const QList<int> &roles) const

QSslConfiguration 类:

(since 6.12) void setKeyingMaterial(const QList<QSslKeyingMaterial> &keyMaterial)
(since 6.12) QList<QSslKeyingMaterial> takeKeyingMaterial()
(since 6.12) std::optional<QSslKeyingMaterial> takeKeyingMaterial(const QSslKeyingMaterial &material)

QTouchEventSequence 类:

(since 6.12) bool cancel(bool processEvents = true)

QTreeView 类:

(since 6.12) QRect itemDecorationRect(const QModelIndex &index) const

QVarLengthArray 类:

(since 6.12) void removeAt(qsizetype i)

QVector2D 类:

(since 6.12) size_t qHash(QVector2D key, size_t seed = 0)

QVector3D 类:

(since 6.12) size_t qHash(QVector3D key, size_t seed = 0)

QVector4D 类:

(since 6.12) size_t qHash(QVector4D key, size_t seed = 0)

QWindow 类:

(since 6.12) void setFramePosition(int x, int y)

qfloat16 类:

(since 6.12) qfloat16 operator+(qfloat16 a)
(since 6.12) qfloat16 &operator++()
(since 6.12) qfloat16 operator++(int)
(since 6.12) qfloat16 &operator--()
(since 6.12) qfloat16 operator--(int)

新的全局函数

(since 6.12) auto compareThreeWay(const std::pair<T1, T2> &lhs, const std::pair<U1, U2> &rhs)

新宏

新的枚举类型

(since 6.12) enum class FillRule { NonZero, EvenOdd }
(technology preview) enum class WarningSeverity { Disable, Info, Warning, Error }
(since 6.12) enum MutabilityGroup { AutoMutabilityGroup, StaticMutabilityGroup, ModerateMutabilityGroup, DynamicMutabilityGroup }
(since 6.12) enum class DropOperation { DontDrop, Automatic, OverwriteAndIgnore, OverwriteAndExtend, InsertAsSiblings, InsertAsChildren }
(since 6.12) enum class DataChangeRelevanceFlag { NotRelevant, RelevantForFiltering, RelevantForSorting, RelevantForFilteringAndSorting }
(since 6.12) enum class ValueMapping { X, Y }
(since 6.12) enum class MotionPreference { NoPreference, ReducedMotion }
(since 6.12) enum class DragMode { Rotate, Pan }
(since 6.12) enum class CompressionAlgorithm { Identity, Deflate, Gzip }

新的枚举值

新的类型别名

新属性

新变量

(since 6.12) const QOperatingSystemVersionBase MacOSGoldenGate

新的 QML 类型

新的 QML 枚举类型

(since 6.12) FinishBehavior

新的 QML 属性

QML 类型Accessible :

(since 6.12) expandable : bool
(since 6.12) expanded : bool

QML 类型AnimatedImage :

(since 6.12) finishBehavior : enumeration
(since 6.12) loops : int

QML 类型CaptureSession :

(since 6.12) nativeVideoSource : GStreamerVideoSource

QML 类型DateTimeAxis :

(since 6.12) tickCount : real

QML 类型DistanceJoint :

(since 6.12) maxDistance : real
(since 6.12) minDistance : real

QML 类型ExtendedSceneEnvironment :

(since 6.12) ssrMaxSteps : int
(since 6.12) ssrThickness : real

QML 类型FolderListModel :

(since 6.12) showDot : bool
(since 6.12) showDotDot : bool

QML 类型GraphsItem3D :

(since 6.12) dragMode : Graphs3D.DragMode
(since 6.12) panEnabled : bool

QML 类型Item :

(since 6.12) mutabilityGroup : int

QML 类型LogValueAxis :

(since 6.12) labelPostFormat : string

QML 类型LottieAnimation :

(since 6.12) currentFrame : int

QML 类型Model :

(since 6.12) instancingLodFactor : real

QML 类型PhysicsJoint :

(since 6.12) bodyA : PhysicsBody*
(since 6.12) bodyB : PhysicsBody*
(since 6.12) orientationA : quaternion
(since 6.12) orientationB : quaternion
(since 6.12) positionA : vector3d
(since 6.12) positionB : vector3d

QML 类型PieSeries :

(since 6.12) sliceData : list<real>
(since 6.12) sliceLabels : list<string>

QML 类型PrismaticJoint :

(since 6.12) lowerLimit : real
(since 6.12) upperLimit : real

QML 类型QuadTextureProvider :

(since 6.12) format : enumeration
(since 6.12) fragmentShader : url
(since 6.12) fragmentShaderCode : string
(since 6.12) height : int
(since 6.12) width : int

QML 类型RevoluteJoint :

(since 6.12) angularLimitLower : real
(since 6.12) angularLimitUpper : real
(since 6.12) enableAngularLimit : bool

QML 类型SceneEnvironment :

(since 6.12) skyMaterial : QtQuick3D::SkyMaterial

QML 类型ScreenCapture :

(since 6.12) maximumFrameRate : real

QML 类型SearchField :

(since 6.12) cursorPosition : int
(since 6.12) placeholderText : string
(since 6.12) selectTextByMouse : bool
(since 6.12) selectedText : string
(since 6.12) selectionEnd : int
(since 6.12) selectionStart : int

QML 类型ShapePath :

(since 6.12) strokeGradient : ShapeGradient

QML 类型SkyMaterial :

(since 6.12) enableIBL : bool
(since 6.12) fragmentShader : url
(since 6.12) fragmentShaderCode : string
(since 6.12) iblRenderFrames : int
(since 6.12) iblSampleCount : int
(since 6.12) radianceMapSize : int
(since 6.12) skyboxMode : enumeration

QML 类型SphericalJoint :

(since 6.12) coneLimitY : real
(since 6.12) coneLimitZ : real
(since 6.12) enableConeLimit : bool

QML 类型ToolTip :

(since 6.12) policy : enumeration

QML 类型ValueAxis :

(since 6.12) labelPostFormat : string

QML 类型VectorImage :

(since 6.12) asynchronous : bool
(since 6.12) generatedItem : Item
(since 6.12) retainWhileLoading : bool
(since 6.12) status : enumeration

QML 类型WindowCapture :

(since 6.12) maximumFrameRate : real

QML 类型XYSeries :

(since 6.12) values : list<variant>

新的 QML 信号

(since 6.12) finished()
(since 6.12) labelPostFormatChanged(string format)
(since 6.12) labelPostFormatChanged(string format)
(since 6.12) sliceDataChanged(list<real> sliceData)
(since 6.12) sliceLabelsChanged(list<string> sliceLabels)
(since 6.12) tickCountChanged(real count)

新的 QML 方法

QML 类型GraphsItem3D :

(since 6.12) void setPanButton(Qt::MouseButtons button)

QML 类型Qt :

(since 6.12) string escapeHtml(string data)

QML 类型RuntimeLoader :

(since 6.12) Object3D query(string arg)
(since 6.12) List<Object3D> queryAll(QueryFilter filter)

QML 类型SearchField :

(since 6.12) void deselect()
(since 6.12) void select(int start, int end)
(since 6.12) void selectAll()
(since 6.12) void selectWord()

QML 类型TreeModel :

(since 6.12) void insertRow(int rowIndex, object row)
(since 6.12) void insertRow(int rowIndex, QModelIndex parent, object row)
(since 6.12) bool moveRows(QModelIndex sourceParent, int sourceRow, int count, QModelIndex destinationParent, int destinationChild)

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