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::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 더블
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::Intint
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::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()`를 사용하십시오.

variant에 저장된 값의 저장 유형을 반환합니다. 이 함수는 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()도 참조하십시오 .

[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 ` 변수형(enum 표현)을 읽습니다.

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