QVariant 的废弃成员

以下为 QVariant 类的已废弃成员。 这些成员提供是为了保持旧源码的兼容性。我们强烈建议不要在新代码中使用它们。

公共类型

公共函数

静态公共成员

相关非成员

成员类型文档

[已废弃] 枚举 QVariant::Type

此枚举类型已废弃。我们强烈建议不要在新代码中使用它。

请改用 QMetaType::Type 代替。

此枚举类型定义了 QVariant 可包含的变量类型。

成员函数文档

[明示的、在6.0中已弃用] QVariant::QVariant(QVariant::Type 类型)

此函数从6.0版本开始已弃用。我们强烈建议不要在新代码中使用它。

请改用带有一个 QMetaType 的构造函数。

创建一个未初始化的类型为 类型 的变体。这将创建一个处于特殊空状态中的变体，如果访问它，将返回 类型 的默认构造值。

另请参阅isNull()。

[在6.0中已弃用] bool QVariant::canConvert(int 目标类型标识符) const

此函数从6.0版本开始已弃用。我们强烈建议不要在新代码中使用它。

这是一个重载函数。

请改用 canConvert(QMetaType(targetTypeId))。

另请参阅QMetaType::canConvert()。

[在6.0中已弃用] bool QVariant::convert(int 目标类型标识符)

此函数从6.0版本开始已弃用。我们强烈建议不要在新代码中使用它。

请改用 convert(QMetaType(targetTypeId))。

将变体强制转换为请求的类型，目标类型标识符。如果无法进行转换，变体仍将被更改为请求的类型，但将被置于类似由 QVariant(Type) 构造的已清除空状态。

如果当前变体的类型成功地生成了转换，则返回 true；否则返回 false。

包含指向从 QObject 派生的类型的指针的 QVariant 也会转换并返回真对此函数，如果 qobject_cast 到由 目标类型标识符 描述的类型将成功。请注意，这仅适用于使用 Q_OBJECT 宏的 QObject 子类。

另请参阅canConvert() 和 clear()。

[静态，在6.0中已弃用] QVariant::Type QVariant::nameToType(const char *名称)

此函数从6.0版本开始已弃用。我们强烈建议不要在新代码中使用它。

请改用 QMetaType::fromName(name).id()。

将 名称 中给出的存储类型的字符串表示形式转换为枚举表示形式。

如果不能将字符串表示形式转换为任何枚举表示形式，则将变体设置为 无效。

[在6.0中已弃用] QVariant::Type QVariant::type() const

此函数从6.0版本开始已弃用。我们强烈建议不要在新代码中使用它。

请改用 typeId() 或 metaType()。

返回存储在变体中的值的存储类型。尽管此函数声明为返回 QVariant::Type，但应将返回值解释为 QMetaType::Type。特别是，只有在值等于或大于 QMetaType::User 时，此处才返回 QVariant::UserType。

请注意，在QVariant::Char范围通过QVariant::RegExp以及QVariant::Font范围通过QVariant::Transform中返回的值对应于在QMetaType::QChar通过QMetaType::QRegularExpression以及QMetaType::QFont通过QMetaType::QQuaternion范围内的值。

当与char和QChar变体一起工作时，请注意。请注意，没有专门为char类型创建的QVariant构造函数，但有一个为QChar类型创建的。对于QChar类型的变体，此函数返回QVariant::Char，与QMetaType::QChar相同，但对于char类型的变体，此函数返回QMetaType::Char，这与QVariant::Char不相同。

此外，请注意，void*、long、short、unsigned long、unsigned short、unsigned char、float、QObject*和QWidget*类型在QMetaType::Type中表示，而不在QVariant::Type中表示，并且可以由此函数返回。然而，当与QVariant::Type测试时，它们被认为是用户定义的类型。

要测试QVariant的实例是否包含与您感兴趣的数据类型兼容的数据类型，请使用canConvert()。

另请参阅 userType()和metaType。

[静态，6.0中已弃用] const char *QVariant::typeToName(int typeId)

此函数从6.0版本开始已弃用。我们强烈建议不要在新代码中使用它。

用QMetaType(typeId).name()代替。

将存储类型（typeId）的int表示形式转换为字符串表示形式。

如果类型是QMetaType::UnknownType或不存在，则返回nullptr。

相关非成员

[已弃用6.0] QDataStream &operator<<(QDataStream &s, const QVariant::Type p)

此函数从6.0版本开始已弃用。我们强烈建议不要在新代码中使用它。

流QMetaType::Type而不是QVariant::Type。

将变体型p写入流s。

[已弃用6.0] QDataStream &operator>>(QDataStream &s, QVariant::Type &p)

此函数从6.0版本开始已弃用。我们强烈建议不要在新代码中使用它。

流QMetaType::Type而不是QVariant::Type。

从流s中读取以枚举表示形式表示的变体型p。