Obsolete Members for QVariant

Los siguientes miembros de la clase ` QVariant ` están obsoletos. Se incluyen para garantizar que el código fuente antiguo siga funcionando. Recomendamos encarecidamente no utilizarlos en código nuevo.

Tipos públicos

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

Elementos 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 sobre tipos de miembros

[deprecated in 6.0] enum QVariant::Type

Esta enumeración está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

Utiliza en su lugar ` QMetaType::Type `.

Este tipo de enumeración define los tipos de variables que puede contener un ` QVariant `.

ConstanteValorDescripción
QVariant::InvalidQMetaType::UnknownTypesin tipo
QVariant::BitArrayQMetaType::QBitArraya QBitArray
QVariant::BitmapQMetaType::QBitmapa QBitmap
QVariant::BoolQMetaType::Boolun 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::Doubleuna doble
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::UserValor base para tipos definidos por el usuario.

Documentación de funciones de miembro

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

Esta función está obsoleta desde la versión 6.0. Recomendamos encarecidamente no utilizarla en código nuevo.

En su lugar, utiliza el constructor que toma un ` QMetaType `.

Crea 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 de ` 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. Recomendamos encarecidamente no utilizarla en código nuevo.

Utiliza en su lugar « canConvert(QMetaType(targetTypeId)) ».

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. Recomendamos encarecidamente no utilizarla en código nuevo.

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

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

Devuelve ` true ` si el tipo actual de la variante se ha convertido correctamente; 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 una conversión ` qobject_cast ` al tipo descrito por ` targetTypeId ` tuviera éxito. Ten en cuenta que esto solo funciona para subclases de ` QObject ` que utilicen la macro ` Q_OBJECT `.

Nota: la conversión de QVariants que sean nulos por no haber sido inicializados o por haber fallado en una conversión anterior siempre fallará, cambiando el tipo, permaneciendo nulos 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. Recomendamos encarecidamente no utilizarla en código nuevo.

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

Convierte la representación como cadena del tipo de almacenamiento indicado en ` name` a su representación como enumeración.

Si la representación como cadena no se puede convertir a ninguna representación de enumeración, 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. Recomendamos encarecidamente no utilizarla en código nuevo.

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

Devuelve el tipo de almacenamiento del valor almacenado en la variante. Aunque esta función está declarada para devolver QVariant::Type, el valor devuelto debe interpretarse como QMetaType::Type. En concreto, aquí solo se devuelve QVariant::UserType si el valor es igual o mayor que QMetaType::User.

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

Presta especial atención al trabajar con variantes de tipo «char» y « QChar ». Ten en cuenta que no existe un constructor « QVariant » específico para el tipo «char», pero sí hay uno para « QChar ». Para una variante de tipo « QChar », esta función devuelve « QVariant::Char », que es lo mismo que « QMetaType::QChar », pero para una variante de tipo « char », esta función devuelve « QMetaType::Char », que no es lo mismo que « QVariant::Char ».

Ten en cuenta 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 esta función puede devolverlos. 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 te interesa, utiliza 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. Recomendamos encarecidamente no utilizarla en código nuevo.

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

Convierte la representación en int del tipo de almacenamiento, ` typeId`, a su representación en cadena.

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

Elementos 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. Recomendamos encarecidamente no utilizarla en código nuevo.

En su lugar, utiliza « QMetaType::Type ».

Escribe un tipo variante 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. Recomendamos encarecidamente no utilizarla en código nuevo.

En su lugar, utiliza « QMetaType::Type ».

Lee un tipo variante « p » en representación de enumeración desde el 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.