Obsolete Members for QVariant

QVariant クラスの以下のメンバーは非推奨となっています。これらは、古いソースコードが引き続き動作するように提供されているものです。新しいコードでの使用は強くお勧めしません。

パブリック型

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

パブリック関数

(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

静的パブリックメンバー

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

関連する非メンバー

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

メンバー型のドキュメント

[deprecated in 6.0] enum QVariant::Type

この列挙型はバージョン 6.0 以降、非推奨となっています。新しいコードでの使用は強く推奨しません。

代わりに `QMetaType::Type ` を使用してください。

この列挙型は、QVariant が保持できる変数の型を定義します。

定数定数値説明
QVariant::InvalidQMetaType::UnknownType型なし
QVariant::BitArrayQMetaType::QBitArrayaQBitArray
QVariant::BitmapQMetaType::QBitmapaQBitmap
QVariant::BoolQMetaType::Boola bool
QVariant::BrushQMetaType::QBrushaQBrush
QVariant::ByteArrayQMetaType::QByteArrayaQByteArray
QVariant::CharQMetaType::QCharaQChar
QVariant::ColorQMetaType::QColoraQColor
QVariant::CursorQMetaType::QCursoraQCursor
QVariant::DateQMetaType::QDateaQDate
QVariant::DateTimeQMetaType::QDateTimeaQDateTime
QVariant::DoubleQMetaType::Doublea double
QVariant::EasingCurveQMetaType::QEasingCurveaQEasingCurve
QVariant::UuidQMetaType::QUuidaQUuid
QVariant::ModelIndexQMetaType::QModelIndexaQModelIndex
QVariant::PersistentModelIndex (since Qt 5.5)QMetaType::QPersistentModelIndexaQPersistentModelIndex
QVariant::FontQMetaType::QFontaQFont
QVariant::HashQMetaType::QVariantHashaQVariantHash
QVariant::IconQMetaType::QIconaQIcon
QVariant::ImageQMetaType::QImageaQImage
QVariant::IntQMetaType::Intint型
QVariant::KeySequenceQMetaType::QKeySequenceaQKeySequence
QVariant::LineQMetaType::QLineaQLine
QVariant::LineFQMetaType::QLineFaQLineF
QVariant::ListQMetaType::QVariantListaQVariantList
QVariant::LocaleQMetaType::QLocaleaQLocale
QVariant::LongLongQMetaType::LongLongaqlonglong
QVariant::MapQMetaType::QVariantMapaQVariantMap
QVariant::TransformQMetaType::QTransformaQTransform
QVariant::Matrix4x4QMetaType::QMatrix4x4aQMatrix4x4
QVariant::PaletteQMetaType::QPaletteaQPalette
QVariant::PenQMetaType::QPenaQPen
QVariant::PixmapQMetaType::QPixmapaQPixmap
QVariant::PointQMetaType::QPointaQPoint
QVariant::PointFQMetaType::QPointFaQPointF
QVariant::PolygonQMetaType::QPolygonaQPolygon
QVariant::PolygonFQMetaType::QPolygonFaQPolygonF
QVariant::QuaternionQMetaType::QQuaternionaQQuaternion
QVariant::RectQMetaType::QRectaQRect
QVariant::RectFQMetaType::QRectFaQRectF
QVariant::RegularExpressionQMetaType::QRegularExpressionaQRegularExpression
QVariant::RegionQMetaType::QRegionaQRegion
QVariant::SizeQMetaType::QSizeaQSize
QVariant::SizeFQMetaType::QSizeFaQSizeF
QVariant::SizePolicyQMetaType::QSizePolicyaQSizePolicy
QVariant::StringQMetaType::QStringaQString
QVariant::StringListQMetaType::QStringListaQStringList
QVariant::TextFormatQMetaType::QTextFormataQTextFormat
QVariant::TextLengthQMetaType::QTextLengthaQTextLength
QVariant::TimeQMetaType::QTimeaQTime
QVariant::UIntQMetaType::UIntauint
QVariant::ULongLongQMetaType::ULongLongaqulonglong
QVariant::UrlQMetaType::QUrlaQUrl
QVariant::Vector2DQMetaType::QVector2DaQVector2D
QVariant::Vector3DQMetaType::QVector3DaQVector3D
QVariant::Vector4DQMetaType::QVector4DaQVector4D
QVariant::UserTypeQMetaType::Userユーザー定義型の基数。

メンバ関数のドキュメント

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

この関数はバージョン 6.0 以降、非推奨となっています。新しいコードでの使用は強く推奨しません。

代わりに、QMetaType を受け取るコンストラクタを使用してください。

type 型の初期化されていないバリアントを生成します。これにより、特別な null 状態のバリアントが作成され、これにアクセスすると、type のデフォルト構築値が返されます。

isNull()も参照してください 。

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

この関数はバージョン 6.0 以降、非推奨となっています。新しいコードでの使用は強く推奨しません。

代わりに `canConvert(QMetaType(targetTypeId)) ` を使用してください。

これはオーバーロードされた関数です。

QMetaType::canConvert()も参照してください 。

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

この関数はバージョン6.0以降、非推奨となっています。新しいコードでの使用は強くお勧めしません。

代わりに `convert(QMetaType(targetTypeId)) ` を使用してください。

バリアントを指定された型、targetTypeId に変換します。変換ができない場合でも、バリアントは指定された型に変更されますが、QVariant(Type) によって生成されるものと同様の、クリアされた null 状態のまま残されます。

バリアントの現在の型が正常にキャストされた場合は `true ` を返し、そうでない場合は `false` を返します。

QObject から派生した型へのポインタを含む `QVariant ` も、targetTypeId で記述された型への `qobject_cast ` が成功する場合、この関数によって変換され、`true` を返します。これは、Q_OBJECT マクロを使用する `QObject ` のサブクラスでのみ機能することに注意してください。

注: 初期化されていない、または以前の変換に失敗したためにnullとなっているQVariantの変換は 常に失敗し、型が変更され、nullのままとなり、false が返されます。

canConvert() およびclear()も参照してください 。

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

この関数はバージョン 6.0 以降、非推奨となっています。新しいコードでの使用は強く推奨しません。

代わりに `QMetaType::fromName(name).id() ` を使用してください。

name で指定されたストレージ型の文字列表現を、その列挙型表現に変換します。

文字列表現をいかなる列挙型表現にも変換できない場合、そのバリアントは `Invalid` に設定されます。

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

この関数はバージョン6.0以降、非推奨となっています。新しいコードでの使用は強く推奨しません。

代わりに、typeId() またはmetaType() を使用してください。

バリアントに格納されている値のストレージ型を返します。この関数はQVariant::Type を返すように宣言されていますが、戻り値はQMetaType::Type として解釈されるべきです。特に、QVariant::UserType が返されるのは、値がQMetaType::User 以上である場合のみです。

なお、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()も参照してください 。

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

この関数はバージョン 6.0 以降、非推奨となっています。新しいコードでの使用は強く推奨しません。

代わりに `QMetaType(typeId).name() ` を使用してください。

ストレージ型 `typeId` の int 表現を、その文字列表現に変換します。

型が `QMetaType::UnknownType ` であるか、存在しない場合は `nullptr ` を返します。

関連する非メンバー関数

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

この関数はバージョン 6.0 以降、非推奨となっています。新しいコードでの使用は強くお勧めしません。

代わりに `QMetaType::Type ` を使用してください。

バリアント型 `p ` をストリーム `s` に書き込みます。

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

この関数はバージョン 6.0 以降、非推奨となっています。新しいコードでの使用は強くお勧めしません。

代わりに `QMetaType::Type ` を使用してください。

ストリーム `s` から、列挙型表現のバリアント型 `p ` を読み取ります。

© 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.