Obsolete Members for QVariant

Les membres suivants de la classe QVariant sont obsolètes. Ils sont fournis pour permettre aux anciens codes sources de continuer à fonctionner. Il est fortement déconseillé de les utiliser dans un nouveau code.

Types publics

(deprecated) 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)

Non-membres apparenté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] enum QVariant::Type

Cette énumération est obsolète. Il est fortement déconseillé de l'utiliser dans un nouveau code.

Utilisez plutôt QMetaType::Type.

Ce type d'énumération définit les types de variables qu'une page QVariant peut contenir.

ConstanteValeurDescription de la variable
QVariant::InvalidQMetaType::UnknownTypeaucun type
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::Doublea double
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::Intan 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. Il est fortement déconseillé de l'utiliser dans un nouveau code.

Utilisez plutôt le constructeur prenant un QMetaType.

Construit une variante non initialisée de type type. Cela créera une variante dans un état spécial null qui, si on y accède, renverra une valeur construite par défaut du type type.

Voir aussi isNull().

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

Cette fonction est obsolète depuis la version 6.0. Il est fortement déconseillé de l'utiliser dans un nouveau code.

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

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

Voir aussi QMetaType::canConvert().

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

Cette fonction est obsolète depuis la version 6.0. Il est fortement déconseillé de l'utiliser dans un nouveau code.

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

Convertit la variante au type demandé, targetTypeId. Si la conversion ne peut pas être faite, la variante est quand même transformée en type demandé, mais elle est laissée dans un état nul, 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 vrai pour cette fonction si un qobject_cast vers le type décrit par targetTypeId réussirait. 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'ils ont échoué lors d'une conversion précédente échouera toujours, en changeant le type, en restant nuls et en renvoyant false.

Voir aussi 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. Il est fortement déconseillé de l'utiliser dans un nouveau code.

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

Convertit la représentation en chaîne du type de stockage donné dans name, en sa représentation enum.

Si la représentation de la chaîne ne peut pas être convertie en une représentation enum, la variante prend la valeur Invalid.

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

Cette fonction est obsolète depuis la version 6.0. Il est fortement déconseillé de l'utiliser dans un nouveau code.

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

Renvoie le type de stockage de la valeur stockée dans la variante. 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 dans les plages QVariant::Char à QVariant::RegExp et QVariant::Font à QVariant::Transform correspondent aux valeurs dans les plages QMetaType::QChar à QMetaType::QRegularExpression et QMetaType::QFont à QMetaType::QQuaternion.

Faites particulièrement attention lorsque vous travaillez avec les variantes char et QChar. Notez qu'il n'y a pas de constructeur QVariant spécifique pour le type char, mais qu'il y en a un pour QChar. Pour une variante du type QChar, cette fonction renvoie QVariant::Char, qui est identique à QMetaType::QChar, mais pour une variante du 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. Il est fortement déconseillé de l'utiliser dans un nouveau code.

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

Convertit la représentation int du type de stockage, typeId, en sa représentation chaîne.

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

Non-membres apparentés

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

Cette fonction est obsolète depuis la version 6.0. Il est fortement déconseillé de l'utiliser dans un nouveau code.

Utilisez plutôt le flux QMetaType::Type.

Écrit une variante de type p 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. Il est fortement déconseillé de l'utiliser dans un nouveau code.

Utilisez plutôt le flux QMetaType::Type.

Lit un type de variante p en représentation enum à 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.