Obsolete Members for QVariant

Les membres suivants de la classe ` QVariant ` sont obsolètes. Ils sont fournis afin de garantir la compatibilité avec l'ancien code source. Nous déconseillons fortement de les utiliser dans du nouveau code.

Types publics

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

Fonctions publiques

(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

Membres publics statiques

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

Éléments non membres associés

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

Documentation sur les types de membres

[deprecated in 6.0] enum QVariant::Type

Cette énumération est obsolète depuis la version 6.0. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Utilisez plutôt ` QMetaType::Type `.

Ce type d'énumération définit les types de variables qu'un « QVariant » peut contenir.

ConstanteValeurDescription
QVariant::InvalidQMetaType::UnknownTypesans type
QVariant::BitArrayQMetaType::QBitArraya QBitArray
QVariant::BitmapQMetaType::QBitmapa QBitmap
QVariant::BoolQMetaType::Boolun booléen
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::Doubleun double
QVariant::EasingCurveQMetaType::QEasingCurvea QEasingCurve
QVariant::UuidQMetaType::QUuida QUuid
QVariant::ModelIndexQMetaType::QModelIndexa QModelIndex
QVariant::PersistentModelIndex (since Qt 5.5)QMetaType::QPersistentModelIndexa QPersistentModelIndex
QVariant::FontQMetaType::QFontun QFont
QVariant::HashQMetaType::QVariantHasha QVariantHash
QVariant::IconQMetaType::QIcona QIcon
QVariant::ImageQMetaType::QImagea QImage
QVariant::IntQMetaType::Intun 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::UserValeur de base pour les types définis par l'utilisateur.

Documentation sur les fonctions membres

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

Cette fonction est obsolète depuis la version 6.0. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Utilisez plutôt le constructeur prenant un ` QMetaType ` en paramètre.

Construit une variante non initialisée de type type. Cela créera une variante dans un état nul spécial qui, si elle est consultée, renverra une valeur construite par défaut de l'type.

Voir également isNull().

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

Cette fonction est obsolète depuis la version 6.0. Nous vous déconseillons vivement de l'utiliser dans du code nouveau.

Utilisez plutôt ` canConvert(QMetaType(targetTypeId)) `.

Il s'agit d'une fonction surchargée.

Voir également QMetaType::canConvert().

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

Cette fonction est obsolète depuis la version 6.0. Nous vous déconseillons vivement de l'utiliser dans du nouveau code.

Utilisez plutôt ` convert(QMetaType(targetTypeId)) `.

Convertit la variante vers le type demandé, targetTypeId. Si la conversion est impossible, la variante est tout de même transformée en type demandé, mais elle est laissée dans un état nul effacé, similaire à celui construit par QVariant(Type).

Renvoie ` true ` si le type actuel de la variante a été converti avec succès ; sinon, renvoie ` false`.

Un ` QVariant ` contenant un pointeur vers un type dérivé de ` QObject ` sera également converti et renverra `true` pour cette fonction si une ` qobject_cast ` vers le type décrit par ` targetTypeId ` aboutissait. Notez que cela ne fonctionne que pour les sous-classes de ` QObject ` qui utilisent la macro ` Q_OBJECT `.

Remarque : la conversion de QVariants qui sont nuls parce qu’ils n’ont pas été initialisés ou qu’une conversion précédente a échoué échouera toujours ; le type sera modifié, la valeur restera nulle et la fonction renverra false.

Voir également canConvert() et clear().

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

Cette fonction est obsolète depuis la version 6.0. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Utilisez plutôt ` QMetaType::fromName(name).id() `.

Convertit la représentation sous forme de chaîne du type de stockage indiqué dans name en sa représentation sous forme d'énumération.

Si la représentation sous forme de chaîne ne peut être convertie en aucune représentation d'énumération, la variante est définie sur ` Invalid`.

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

Cette fonction est obsolète depuis la version 6.0. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Utilisez plutôt ` typeId()` ou ` metaType()`.

Renvoie le type de stockage de la valeur stockée dans le variant. Bien que cette fonction soit déclarée comme renvoyant QVariant::Type, la valeur de retour doit être interprétée comme QMetaType::Type. En particulier, QVariant::UserType n’est renvoyé ici que si la valeur est égale ou supérieure à QMetaType::User.

Notez que les valeurs de retour comprises entre QVariant::Char et QVariant::RegExp, d’une part, et entre QVariant::Font et QVariant::Transform, d’autre part, correspondent aux valeurs comprises respectivement entre QMetaType::QChar et QMetaType::QRegularExpression, et entre QMetaType::QFont et QMetaType::QQuaternion.

Soyez particulièrement vigilant lorsque vous travaillez avec des variantes de type char et QChar. Notez qu’il n’existe pas de constructeur QVariant spécifique au type char, mais qu’il en existe un pour QChar. Pour une variante de type QChar, cette fonction renvoie QVariant::Char, qui est identique à QMetaType::QChar, mais pour une variante de type char, cette fonction renvoie QMetaType::Char, qui n’ est pas identique à QVariant::Char.

Notez également que les types void*, long, short, unsigned, long, unsigned, short, unsigned, char, float, QObject* et QWidget* sont représentés dans QMetaType::Type mais pas dans QVariant::Type, et qu’ils peuvent être renvoyés par cette fonction. Cependant, ils sont considérés comme des types définis par l’utilisateur lorsqu’ils sont testés par rapport à QVariant::Type.

Pour vérifier si une instance de QVariant contient un type de données compatible avec le type de données qui vous intéresse, utilisez canConvert().

Voir également userType() et metaType().

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

Cette fonction est obsolète depuis la version 6.0. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Utilisez plutôt ` QMetaType(typeId).name() `.

Convertit la représentation « int » du type de stockage, typeId, en sa représentation sous forme de chaîne de caractères.

Renvoie ` nullptr ` si le type est ` QMetaType::UnknownType ` ou s'il n'existe pas.

Éléments non membres associés

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

Cette fonction est obsolète depuis la version 6.0. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Utilisez plutôt la fonction ` QMetaType::Type `.

Écrit une p de type variant dans le flux s.

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

Cette fonction est obsolète depuis la version 6.0. Nous vous déconseillons fortement de l'utiliser dans du nouveau code.

Utilisez plutôt la fonction ` QMetaType::Type `.

Lit une p de type variant sous forme d'énumération à partir du flux 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.