Obsolete Members for QVariant

Los siguientes miembros de la clase QVariant son obsoletos. Se proporcionan para que el código fuente antiguo siga funcionando. Desaconsejamos su uso en código nuevo.

Tipos públicos

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

Funciones públicas

(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

Miembros públicos estáticos

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

No miembros relacionados

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

Documentación de tipos de miembros

[deprecated] enum QVariant::Type

Este enum está obsoleto. Desaconsejamos su uso en código nuevo.

Utilice QMetaType::Type en su lugar.

Este tipo enum define los tipos de variable que puede contener un QVariant.

ConstanteValorDescripción
QVariant::InvalidQMetaType::UnknownTypesin tipo
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 doble
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::Inta 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::UserValor base para tipos definidos por el usuario.

Documentación de las funciones miembro

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

Esta función está obsoleta desde la versión 6.0. Desaconsejamos su uso en código nuevo.

Utilice en su lugar el constructor que toma un QMetaType.

Construye una variante no inicializada de tipo type. Esto creará una variante en un estado nulo especial que, si se accede a ella, devolverá un valor construido por defecto del tipo type.

Véase también isNull().

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

Esta función está obsoleta desde la versión 6.0. Desaconsejamos su uso en código nuevo.

Utilice canConvert(QMetaType(targetTypeId)) en su lugar.

Esta es una función sobrecargada.

Véase también QMetaType::canConvert().

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

Esta función está obsoleta desde la versión 6.0. Desaconsejamos su uso en código nuevo.

Utilice convert(QMetaType(targetTypeId)) en su lugar.

Convierte la variante al tipo solicitado, targetTypeId. Si no se puede realizar la conversión, la variante se cambia al tipo solicitado, pero se deja en un estado nulo similar al construido por QVariant(Type).

Devuelve true si el tipo actual de la variante se ha convertido con éxito; en caso contrario, devuelve false.

Un QVariant que contenga un puntero a un tipo derivado de QObject también se convertirá y devolverá true para esta función si un qobject_cast al tipo descrito por targetTypeId tuviera éxito. Tenga en cuenta que esto sólo funciona para las subclases de QObject que utilizan la macro Q_OBJECT.

Nota: la conversión de QVariants que son null debido a que no han sido inicializadas o han fallado una conversión previa siempre fallará, cambiando el tipo, permaneciendo null, y devolviendo false.

Véase también canConvert() y clear().

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

Esta función está obsoleta desde la versión 6.0. Desaconsejamos encarecidamente su uso en código nuevo.

Utilice QMetaType::fromName(name).id() en su lugar

Convierte la representación de cadena del tipo de almacenamiento dado en name, a su representación enum.

Si la representación de cadena no puede convertirse a ninguna representación enum, la variante se establece en Invalid.

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

Esta función está obsoleta desde la versión 6.0. Desaconsejamos su uso en código nuevo.

Utilice typeId() o metaType() en su lugar.

Devuelve el tipo de almacenamiento del valor almacenado en la variante. Aunque se declara que esta función devuelve QVariant::Type, el valor devuelto debe interpretarse como QMetaType::Type. En particular, QVariant::UserType se devuelve aquí sólo si el valor es igual o mayor que QMetaType::User.

Tenga en cuenta que los valores de retorno en los rangos QVariant::Char a través de QVariant::RegExp y QVariant::Font a través de QVariant::Transform corresponden a los valores en los rangos QMetaType::QChar a través de QMetaType::QRegularExpression y QMetaType::QFont a través de QMetaType::QQuaternion.

Preste especial atención cuando trabaje con variantes char y QChar. Tenga en cuenta que no existe un constructor QVariant específico para el tipo char, pero sí para QChar. Para una variante del tipo QChar, esta función devuelve QVariant::Char, que es lo mismo que QMetaType::QChar, pero para una variante del tipo char, esta función devuelve QMetaType::Char, que no es lo mismo que QVariant::Char.

Observe también que los tipos void*, long, short, unsigned long , unsigned short , unsigned char , float, QObject*, y QWidget* están representados en QMetaType::Type pero no en QVariant::Type, y pueden ser devueltos por esta función. Sin embargo, se consideran tipos definidos por el usuario cuando se comprueban con QVariant::Type.

Para comprobar si una instancia de QVariant contiene un tipo de datos compatible con el tipo de datos que le interesa, utilice canConvert().

Véase también userType() y metaType().

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

Esta función está obsoleta desde la versión 6.0. Desaconsejamos su uso en código nuevo.

Utilice QMetaType(typeId).name() en su lugar.

Convierte la representación int del tipo de almacenamiento, typeId, a su representación string.

Devuelve nullptr si el tipo es QMetaType::UnknownType o no existe.

No miembros relacionados

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

Esta función está obsoleta desde la versión 6.0. Desaconsejamos su uso en código nuevo.

En su lugar, utilice el flujo QMetaType::Type.

Escribe una variante de tipo p en el flujo s.

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

Esta función está obsoleta desde la versión 6.0. Desaconsejamos su uso en código nuevo.

En su lugar, utilice el flujo QMetaType::Type.

Lee una variante de tipo p en representación enum del flujo 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.