Obsolete Members for QVariant

Die folgenden Mitglieder der Klasse „ QVariant “ sind veraltet. Sie werden bereitgestellt, damit alter Quellcode weiterhin funktioniert. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Öffentliche Typen

(deprecated in 6.0) enum Type { Invalid, BitArray, Bitmap, Bool, Brush, …, UserType }

Öffentliche Funktionen

(deprecated in 6.0) QVariant(QVariant::Type type)
(deprecated in 6.0) bool canConvert(int targetTypeId) const
(deprecated in 6.0) bool convert(int targetTypeId)
(deprecated in 6.0) QVariant::Type type() const

Statische öffentliche Mitglieder

(deprecated in 6.0) QVariant::Type nameToType(const char *name)
(deprecated in 6.0) const char *typeToName(int typeId)

Verwandte Nicht-Mitglieder

(deprecated in 6.0) QDataStream &operator<<(QDataStream &s, const QVariant::Type p)
(deprecated in 6.0) QDataStream &operator>>(QDataStream &s, QVariant::Type &p)

Dokumentation zu Mitgliedstypen

[deprecated in 6.0] enum QVariant::Type

Diese Enumeration ist seit Version 6.0 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Verwenden Sie stattdessen „ QMetaType::Type “.

Dieser Enum-Typ definiert die Variablentypen, die ein „ QVariant “ enthalten kann.

KonstanteWertBeschreibung
QVariant::InvalidQMetaType::UnknownTypekein Typ
QVariant::BitArrayQMetaType::QBitArraya QBitArray
QVariant::BitmapQMetaType::QBitmapa QBitmap
QVariant::BoolQMetaType::Boola bool
QVariant::BrushQMetaType::QBrusha QBrush
QVariant::ByteArrayQMetaType::QByteArraya QByteArray
QVariant::CharQMetaType::QChara QChar
QVariant::ColorQMetaType::QColora QColor
QVariant::CursorQMetaType::QCursora QCursor
QVariant::DateQMetaType::QDatea QDate
QVariant::DateTimeQMetaType::QDateTimea QDateTime
QVariant::DoubleQMetaType::Doubleein Doppelzimmer
QVariant::EasingCurveQMetaType::QEasingCurvea QEasingCurve
QVariant::UuidQMetaType::QUuida QUuid
QVariant::ModelIndexQMetaType::QModelIndexa QModelIndex
QVariant::PersistentModelIndex (since Qt 5.5)QMetaType::QPersistentModelIndexa QPersistentModelIndex
QVariant::FontQMetaType::QFonta QFont
QVariant::HashQMetaType::QVariantHasha QVariantHash
QVariant::IconQMetaType::QIcona QIcon
QVariant::ImageQMetaType::QImagea QImage
QVariant::IntQMetaType::Intein int
QVariant::KeySequenceQMetaType::QKeySequencea QKeySequence
QVariant::LineQMetaType::QLinea QLine
QVariant::LineFQMetaType::QLineFa QLineF
QVariant::ListQMetaType::QVariantLista QVariantList
QVariant::LocaleQMetaType::QLocalea QLocale
QVariant::LongLongQMetaType::LongLonga qlonglong
QVariant::MapQMetaType::QVariantMapa QVariantMap
QVariant::TransformQMetaType::QTransforma QTransform
QVariant::Matrix4x4QMetaType::QMatrix4x4a QMatrix4x4
QVariant::PaletteQMetaType::QPalettea QPalette
QVariant::PenQMetaType::QPena QPen
QVariant::PixmapQMetaType::QPixmapa QPixmap
QVariant::PointQMetaType::QPointa QPoint
QVariant::PointFQMetaType::QPointFa QPointF
QVariant::PolygonQMetaType::QPolygona QPolygon
QVariant::PolygonFQMetaType::QPolygonFa QPolygonF
QVariant::QuaternionQMetaType::QQuaterniona QQuaternion
QVariant::RectQMetaType::QRecta QRect
QVariant::RectFQMetaType::QRectFa QRectF
QVariant::RegularExpressionQMetaType::QRegularExpressiona QRegularExpression
QVariant::RegionQMetaType::QRegiona QRegion
QVariant::SizeQMetaType::QSizea QSize
QVariant::SizeFQMetaType::QSizeFa QSizeF
QVariant::SizePolicyQMetaType::QSizePolicya QSizePolicy
QVariant::StringQMetaType::QStringa QString
QVariant::StringListQMetaType::QStringLista QStringList
QVariant::TextFormatQMetaType::QTextFormata QTextFormat
QVariant::TextLengthQMetaType::QTextLengtha QTextLength
QVariant::TimeQMetaType::QTimea QTime
QVariant::UIntQMetaType::UInta uint
QVariant::ULongLongQMetaType::ULongLonga qulonglong
QVariant::UrlQMetaType::QUrla QUrl
QVariant::Vector2DQMetaType::QVector2Da QVector2D
QVariant::Vector3DQMetaType::QVector3Da QVector3D
QVariant::Vector4DQMetaType::QVector4Da QVector4D
QVariant::UserTypeQMetaType::UserBasiswert für benutzerdefinierte Typen.

Dokumentation zu Mitgliedsfunktionen

[explicit, deprecated in 6.0] QVariant::QVariant(QVariant::Type type)

Diese Funktion ist seit Version 6.0 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Verwenden Sie stattdessen den Konstruktor, der eine ` QMetaType ` als Argument benötigt.

Erzeugt eine nicht initialisierte Variante vom Typ „ type “. Dadurch wird eine Variante in einem speziellen Null-Zustand erstellt, die bei Zugriff einen standardmäßig konstruierten Wert des „ type “ zurückgibt.

Siehe auch „ isNull()“.

[deprecated in 6.0] bool QVariant::canConvert(int targetTypeId) const

Diese Funktion ist seit Version 6.0 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Verwenden Sie stattdessen „ canConvert(QMetaType(targetTypeId)) “.

Dies ist eine überladene Funktion.

Siehe auch ` QMetaType::canConvert()`.

[deprecated in 6.0] bool QVariant::convert(int targetTypeId)

Diese Funktion ist seit Version 6.0 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Verwenden Sie stattdessen „ convert(QMetaType(targetTypeId)) “.

Wandelt die Variante in den gewünschten Typ um, targetTypeId. Wenn die Umwandlung nicht möglich ist, wird die Variante zwar dennoch in den gewünschten Typ umgewandelt, bleibt jedoch in einem geleerten Null-Zustand, ähnlich dem, der durch QVariant(Type) erzeugt wird.

Gibt „ true “ zurück, wenn der aktuelle Typ der Variant erfolgreich umgewandelt wurde; andernfalls wird „ false “ zurückgegeben.

Ein ` QVariant `, das einen Zeiger auf einen von ` QObject ` abgeleiteten Typ enthält, wird ebenfalls konvertiert und gibt für diese Funktion `true` zurück, sofern eine ` qobject_cast ` in den durch ` targetTypeId ` beschriebenen Typ erfolgreich wäre. Beachten Sie, dass dies nur für Unterklassen von ` QObject ` funktioniert, die das Makro ` Q_OBJECT ` verwenden.

Hinweis: Die Konvertierung von QVariants, die null sind, weil sie nicht initialisiert wurden oder bei einer vorherigen Konvertierung fehlgeschlagen sind, schlägt immer fehl, wobei der Typ geändert wird, der Wert null bleibt und „ false “ zurückgegeben wird.

Siehe auch canConvert() und clear().

[static, deprecated in 6.0] QVariant::Type QVariant::nameToType(const char *name)

Diese Funktion ist seit Version 6.0 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Verwenden Sie stattdessen „ QMetaType::fromName(name).id() “.

Konvertiert die Zeichenfolgendarstellung des in ` name` angegebenen Speichertyps in dessen Enum-Darstellung.

Wenn die Zeichenfolgenrepräsentation nicht in eine Enum-Repräsentation konvertiert werden kann, wird die Variante auf ` Invalid` gesetzt.

[deprecated in 6.0] QVariant::Type QVariant::type() const

Diese Funktion ist seit Version 6.0 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Verwenden Sie stattdessen „ typeId()“ oder „ metaType()“.

Gibt den Speichertyp des in der Variante gespeicherten Werts zurück. Obwohl diese Funktion so deklariert ist, dass sie ` QVariant::Type` zurückgibt, sollte der Rückgabewert als ` QMetaType::Type` interpretiert werden. Insbesondere wird hier nur dann ` QVariant::UserType ` zurückgegeben, wenn der Wert gleich oder größer als ` QMetaType::User` ist.

Beachten Sie, dass Rückgabewerte in den Bereichen von „ QVariant::Char “ bis „QVariant::RegExp“ und von „ QVariant::Font “ bis „ QVariant::Transform “ den Werten in den Bereichen von „ QMetaType::QChar “ bis „ QMetaType::QRegularExpression “ sowie von „ QMetaType::QFont “ bis „ QMetaType::QQuaternion “ entsprechen.

Seien Sie besonders vorsichtig, wenn Sie mit Varianten vom Typ „char“ und „ QChar “ arbeiten. Beachten Sie, dass es keinen Konstruktor „ QVariant “ speziell für den Typ „char“ gibt, wohl aber einen für „ QChar “. Für eine Variante vom Typ „ QChar “ gibt diese Funktion „ QVariant::Char “ zurück, was mit „ QMetaType::QChar “ identisch ist; für eine Variante vom Typ „ char “ gibt diese Funktion jedoch „ QMetaType::Char “ zurück, was nicht mit „ QVariant::Char “ identisch ist.

Beachten Sie außerdem, dass die Typen void*, long, short, unsigned, long, unsigned, short, unsigned, char, float, QObject* und QWidget* in QMetaType::Type, jedoch nicht in QVariant::Type vertreten sind und von dieser Funktion zurückgegeben werden können. Bei der Prüfung anhand von QVariant::Type gelten sie jedoch als benutzerdefinierte Typen.

Um zu prüfen, ob eine Instanz von „ QVariant “ einen Datentyp enthält, der mit dem gewünschten Datentyp kompatibel ist, verwenden Sie „ canConvert()“.

Siehe auch „ userType()“ und „ metaType()“.

[static, deprecated in 6.0] const char *QVariant::typeToName(int typeId)

Diese Funktion ist seit Version 6.0 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Verwenden Sie stattdessen ` QMetaType(typeId).name() `.

Konvertiert die int-Darstellung des Speichertyps „ typeId “ in dessen Zeichenfolgendarstellung.

Gibt ` nullptr ` zurück, wenn der Typ ` QMetaType::UnknownType ` ist oder nicht existiert.

Verwandte Nicht-Mitglieder

[deprecated in 6.0] QDataStream &operator<<(QDataStream &s, const QVariant::Type p)

Diese Funktion ist seit Version 6.0 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Verwenden Sie stattdessen „ QMetaType::Type “.

Schreibt eine Variant- p in den Stream s.

[deprecated in 6.0] QDataStream &operator>>(QDataStream &s, QVariant::Type &p)

Diese Funktion ist seit Version 6.0 veraltet. Wir raten dringend davon ab, sie in neuem Code zu verwenden.

Verwenden Sie stattdessen „ QMetaType::Type “.

Liest eine Variant- p in Enum-Darstellung aus dem Stream s.

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