QVariant Class Reference · PyQt4 中文文檔

# QVariant Class Reference ## [[QtCore](index.htm) module] 該的QVariant類的行為像最常見的Qt數據類型的聯合。[More...](#details) ### Types * `enum Type { Invalid, Bool, Int, UInt, ..., UserType }` ### Methods * `__init__ (self)` * `__init__ (self, Type?type)` * `__init__ (self, int?typeOrUserType, sip.voidptr?copy)` * `__init__ (self, QVariant?other)` * `__init__ (self, object)` * `bool canConvert (self, Type?t)` * `clear (self)` * `bool convert (self, Type?t)` * `sip.voidptr data (self)` * `detach (self)` * `bool isDetached (self)` * `bool isNull (self)` * `bool isValid (self)` * `load (self, QDataStream?ds)` * `save (self, QDataStream?ds)` * `swap (self, QVariant?other)` * `QBitArray toBitArray (self)` * `bool toBool (self)` * `QByteArray toByteArray (self)` * `QChar toChar (self)` * `QDate toDate (self)` * `QDateTime toDateTime (self)` * `(float, bool?ok) toDouble (self)` * `QEasingCurve toEasingCurve (self)` * `(float, bool?ok) toFloat (self)` * `dict-of-QString-QVariant toHash (self)` * `(int, bool?ok) toInt (self)` * `QLine toLine (self)` * `QLineF toLineF (self)` * `list-of-QVariant toList (self)` * `QLocale toLocale (self)` * `(int, bool?ok) toLongLong (self)` * `dict-of-QString-QVariant toMap (self)` * `QPoint toPoint (self)` * `QPointF toPointF (self)` * `object toPyObject (self)` * `(float, bool?ok) toReal (self)` * `QRect toRect (self)` * `QRectF toRectF (self)` * `QRegExp toRegExp (self)` * `QSize toSize (self)` * `QSizeF toSizeF (self)` * `QString toString (self)` * `QStringList toStringList (self)` * `QTime toTime (self)` * `(int, bool?ok) toUInt (self)` * `(int, bool?ok) toULongLong (self)` * `QUrl toUrl (self)` * `Type type (self)` * `str typeName (self)` * `int userType (self)` ### Static Methods * `QVariant fromList (list-of-QVariant?list)` * `QVariant fromMap (dict-of-QString-QVariant?map)` * `Type nameToType (str?name)` * `str typeToName (Type?type)` ### Special Methods * `bool __eq__ (self, QVariant?v)` * `bool __ne__ (self, QVariant?v)` * * * ## Detailed Description 可以使用任何Python對象每當一個[QVariant](qvariant.html)預計。沒有人會被解釋為無效的QVariant 。該的QVariant類的行為像最常見的Qt數據類型的聯合。因為C + +不允許從包括具有非默認的構造函數或析構函數類型的工會，最有趣的Qt類不能在工會使用。沒有的QVariant ，這將是一個問題[QObject.property](qobject.html#property)（）和數據庫的工作，等等。一個的QVariant對象持有一個單一的單個值[type](qvariant.html#type)（）的時間。（有些[type](qvariant.html#type)（） S是多值，例如一個字符串列表。）你可以找出哪些類型，T變種持有，使用它轉換為不同的類型[convert](qvariant.html#convert)（），取得使用TOT之一，它的值（）函數（例如，[toSize](qvariant.html#toSize)（）），并檢查是否該類型可以使用被轉換成特定類型的[canConvert](qvariant.html#canConvert)（）。名為TOT （）的方法（例如，[toInt](qvariant.html#toInt)（）[toString](qvariant.html#toString)（））是常量。如果你問的存儲類型，它們返回的存儲對象的一個副本。如果要求，可以從所存儲的類型， TOT （）的拷貝和轉換來生成和葉對象本身不變型。如果你問的是不能從存儲的類型生成的類型，其結果取決于類型，詳見函數文檔。下面是一些示例代碼來演示使用的QVariant的： ``` [QDataStream](qdatastream.html) out(...); QVariant v(123); // The variant now contains an int int x = v.toInt(); // x = 123 out << v; // Writes a type tag and an int to out v = QVariant("hello"); // The variant now contains a QByteArray v = QVariant(tr("hello")); // The variant now contains a QString int y = v.toInt(); // y = 0 since v cannot be converted to an int [QString](qstring.html) s = v.toString(); // s = tr("hello") (see QObject.tr()) out << v; // Writes a type tag and a QString to out ... [QDataStream](qdatastream.html) in(...); // (opening the previously written stream) in >> v; // Reads an Int variant int z = v.toInt(); // z = 123 qDebug("Type is %s", // prints "Type is int" v.typeName()); v = v.toInt() + 100; // The variant now hold the value 223 v = QVariant([QStringList](qstringlist.html)()); ``` 你甚至可以存儲[QList](index.htm)\u003cQVariant\u003e和[QMap](index.htm)\u003c[QString](qstring.html)在一個變體的QVariant \u003e的值，這樣你就可以很容易地構造任意類型的任意復雜的數據結構。這是非常強大和靈活，但可能證明較少的內存和速度效率比存儲特定類型的標準數據結構。的QVariant還支持空值，在那里你可以有一個定義的類型，沒有值集的概念。但是請注意，當他們有一個值集的QVariant類型只能被施放。 ``` QVariant x, y([QString](qstring.html)()), z([QString](qstring.html)("")); x.convert(QVariant.Int); // x.isNull() == true // y.isNull() == true, z.isNull() == false ``` 的QVariant可以擴展到支持其他類型比在提及[Type](qvariant.html#Type-enum)枚舉。請參閱[QMetaType](qmetatype.html)文檔。 ### A Note on GUI Types 因為是的QVariant的部分[QtCore](index.htm)庫，它不能提供轉換功能，以定義數據類型[QtGui](index.htm)如[QColor](qcolor.html)，[QImage](qimage.html)和[QPixmap](qpixmap.html)。換句話說，沒有`toColor()`功能。相反，你可以使用[QVariant.value](qvariant.html#value)（）或[qvariant_cast](qvariant.html#qvariant_cast)（）模板函數。例如： ``` QVariant variant; ... [QColor](qcolor.html) color = variant.value<[QColor](qcolor.html)>(); ``` 逆變換（例如，從[QColor](qcolor.html)到的QVariant ）是自動通過的QVariant支持的所有數據類型，包括GUI相關的類： ``` [QColor](qcolor.html) color = palette().background().color(); QVariant variant = color; ``` ### Using canConvert() and convert() Consecutively 當使用[canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）連續，它有可能為[canConvert](qvariant.html#canConvert)（）返回True ，但[convert](qvariant.html#convert)（）返回False 。這通常是因為[canConvert](qvariant.html#canConvert)（）只報告的QVariant來給出合適的數據類型之間進行轉換的一般能力，它仍然是可能的，以提供其實際上不能被轉換的數據。例如，[canConvert](qvariant.html#canConvert)（）會叫上一個包含字符串變量的時候，因為在原則上，是的QVariant能夠數字字符串轉換為整數返回True 。然而，如果字符串中包含非數字字符時，它不能被轉換成一個整數，并且任何試圖將其轉換將失敗。因此，有兩個函數返回True，對于一個成功的轉換是非常重要的。 * * * ## Type Documentation ``` QVariant.Type ``` 這個枚舉類型定義變量的類型，一個[QVariant](qvariant.html)可以包含。 | Constant | Value | Description | | --- | --- | --- | | `QVariant.Invalid` | `0` | 沒有類型 | | `QVariant.BitArray` | `13` | 一[QBitArray](qbitarray.html) | | `QVariant.Bitmap` | `73` | 一[QBitmap](qbitmap.html) | | `QVariant.Bool` | `1` | 一個bool | | `QVariant.Brush` | `66` | 一[QBrush](qbrush.html) | | `QVariant.ByteArray` | `12` | 一[QByteArray](qbytearray.html) | | `QVariant.Char` | `7` | 一[QChar](qchar.html) | | `QVariant.Color` | `67` | 一[QColor](qcolor.html) | | `QVariant.Cursor` | `74` | 一[QCursor](qcursor.html) | | `QVariant.Date` | `14` | 一[QDate](qdate.html) | | `QVariant.DateTime` | `16` | 一[QDateTime](qdatetime.html) | | `QVariant.Double` | `6` | 雙 | | `QVariant.EasingCurve` | `29` | 一[QEasingCurve](qeasingcurve.html) | | `QVariant.Font` | `64` | 一[QFont](qfont.html) | | `QVariant.Hash` | `28` | 一[QVariantHash](qvariant.html#QVariantHash-typedef) | | `QVariant.Icon` | `69` | 一[QIcon](qicon.html) | | `QVariant.Image` | `70` | 一[QImage](qimage.html) | | `QVariant.Int` | `2` | 一個int | | `QVariant.KeySequence` | `76` | 一[QKeySequence](qkeysequence.html) | | `QVariant.Line` | `23` | 一[QLine](qline.html) | | `QVariant.LineF` | `24` | 一[QLineF](qlinef.html) | | `QVariant.List` | `9` | 一[QVariantList](qvariant.html#QVariantList-typedef) | | `QVariant.Locale` | `18` | 一[QLocale](qlocale.html) | | `QVariant.LongLong` | `4` | 一[qlonglong](index.htm#qlonglong-typedef) | | `QVariant.Map` | `8` | 一[QVariantMap](qvariant.html#QVariantMap-typedef) | | `QVariant.Matrix` | `80` | 一[QMatrix(obsolete)](qmatrix.html) | | `QVariant.Transform` | `81` | 一[QTransform](qtransform.html) | | `QVariant.Matrix4x4` | `82` | 一[QMatrix4x4](qmatrix4x4.html) | | `QVariant.Palette` | `68` | 一[QPalette](qpalette.html) | | `QVariant.Pen` | `77` | 一[QPen](qpen.html) | | `QVariant.Pixmap` | `65` | 一[QPixmap](qpixmap.html) | | `QVariant.Point` | `25` | 一[QPoint](qpoint.html) | | `QVariant.PointArray` | `Polygon` | 一[QPointArray](index.htm#qpointarray) | | `QVariant.PointF` | `26` | 一[QPointF](qpointf.html) | | `QVariant.Polygon` | `71` | 一[QPolygon](qpolygon.html) | | `QVariant.Quaternion` | `86` | 一[QQuaternion](qquaternion.html) | | `QVariant.Rect` | `19` | 一[QRect](qrect.html) | | `QVariant.RectF` | `20` | 一[QRectF](qrectf.html) | | `QVariant.RegExp` | `27` | 一[QRegExp](qregexp.html) | | `QVariant.Region` | `72` | 一[QRegion](qregion.html) | | `QVariant.Size` | `21` | 一[QSize](qsize.html) | | `QVariant.SizeF` | `22` | 一[QSizeF](qsizef.html) | | `QVariant.SizePolicy` | `75` | 一[QSizePolicy](qsizepolicy.html) | | `QVariant.String` | `10` | 一[QString](qstring.html) | | `QVariant.StringList` | `11` | 一[QStringList](qstringlist.html) | | `QVariant.TextFormat` | `79` | 一[QTextFormat](qtextformat.html) | | `QVariant.TextLength` | `78` | 一[QTextLength](qtextlength.html) | | `QVariant.Time` | `15` | 一[QTime](qtime.html) | | `QVariant.UInt` | `3` | 一[uint](index.htm#uint-typedef) | | `QVariant.ULongLong` | `5` | 一[qulonglong](index.htm#qulonglong-typedef) | | `QVariant.Url` | `17` | 一[QUrl](qurl.html) | | `QVariant.Vector2D` | `83` | 一[QVector2D](qvector2d.html) | | `QVariant.Vector3D` | `84` | 一[QVector3D](qvector3d.html) | | `QVariant.Vector4D` | `85` | 一[QVector4D](qvector4d.html) | | `QVariant.UserType` | `127` | 對于用戶自定義類型的基礎值。 | * * * ## Method Documentation ``` QVariant.__init__ (self) ``` 構造一個無效的變體。 ``` QVariant.__init__ (self, Type?type) ``` 構造類型的空變種_type_。 ``` QVariant.__init__ (self, int?typeOrUserType, sip.voidptr?copy) ``` 構造類型的變種_typeOrUserType_以及與初始化_copy_如果_copy_不為0。請注意，你必須通過你想要保存的變量的地址。通常情況下，你從來沒有使用此構造函數，使用[QVariant.fromValue](qvariant.html#fromValue)（）而不是由所代表的指針類型構造變形`QMetaType.VoidStar`，`QMetaType.QObjectStar`和`QMetaType.QWidgetStar`。 **See also** [QVariant.fromValue](qvariant.html#fromValue)（）和[Type](qvariant.html#Type-enum)。 ``` QVariant.__init__ (self, QVariant?other) ``` ``` QVariant.__init__ (self, object) ``` 構造變形的副本，_p_，作為參數傳遞給此構造函數。 ``` bool QVariant.canConvert (self, Type?t) ``` 返回True如果變量的類型可以轉換為所請求的類型，_t_。當調用此類鑄件是自動完成的[toInt](qvariant.html#toInt)（）[toBool](qvariant.html#toBool)（），...的方法。下面的類型轉換是自動完成的： | Type | Automatically Cast To | | --- | --- | | [Bool](qvariant.html#Type-enum) | [Char](qvariant.html#Type-enum), [Double](qvariant.html#Type-enum), [Int](qvariant.html#Type-enum), [LongLong](qvariant.html#Type-enum), [String](qvariant.html#Type-enum), [UInt](qvariant.html#Type-enum), [ULongLong](qvariant.html#Type-enum) | | [ByteArray](qvariant.html#Type-enum) | [Double](qvariant.html#Type-enum), [Int](qvariant.html#Type-enum), [LongLong](qvariant.html#Type-enum), [String](qvariant.html#Type-enum), [UInt](qvariant.html#Type-enum), [ULongLong](qvariant.html#Type-enum) | | [Char](qvariant.html#Type-enum) | [Bool](qvariant.html#Type-enum), [Int](qvariant.html#Type-enum), [UInt](qvariant.html#Type-enum), [LongLong](qvariant.html#Type-enum), [ULongLong](qvariant.html#Type-enum) | | [Color](qvariant.html#Type-enum) | [String](qvariant.html#Type-enum) | | [Date](qvariant.html#Type-enum) | [DateTime](qvariant.html#Type-enum), [String](qvariant.html#Type-enum) | | [DateTime](qvariant.html#Type-enum) | [Date](qvariant.html#Type-enum), [String](qvariant.html#Type-enum), [Time](qvariant.html#Type-enum) | | [Double](qvariant.html#Type-enum) | [Bool](qvariant.html#Type-enum), [Int](qvariant.html#Type-enum), [LongLong](qvariant.html#Type-enum), [String](qvariant.html#Type-enum), [UInt](qvariant.html#Type-enum), [ULongLong](qvariant.html#Type-enum) | | [Font](qvariant.html#Type-enum) | [String](qvariant.html#Type-enum) | | [Int](qvariant.html#Type-enum) | [Bool](qvariant.html#Type-enum), [Char](qvariant.html#Type-enum), [Double](qvariant.html#Type-enum), [LongLong](qvariant.html#Type-enum), [String](qvariant.html#Type-enum), [UInt](qvariant.html#Type-enum), [ULongLong](qvariant.html#Type-enum) | | [KeySequence](qvariant.html#Type-enum) | [Int](qvariant.html#Type-enum), [String](qvariant.html#Type-enum) | | [List](qvariant.html#Type-enum) | [StringList](qvariant.html#Type-enum) (if the list's items can be converted to strings) | | [LongLong](qvariant.html#Type-enum) | [Bool](qvariant.html#Type-enum), [ByteArray](qvariant.html#Type-enum), [Char](qvariant.html#Type-enum), [Double](qvariant.html#Type-enum), [Int](qvariant.html#Type-enum), [String](qvariant.html#Type-enum), [UInt](qvariant.html#Type-enum), [ULongLong](qvariant.html#Type-enum) | | [Point](qvariant.html#Type-enum) | [PointF](qvariant.html#Type-enum) | | [Rect](qvariant.html#Type-enum) | [RectF](qvariant.html#Type-enum) | | [String](qvariant.html#Type-enum) | [Bool](qvariant.html#Type-enum), [ByteArray](qvariant.html#Type-enum), [Char](qvariant.html#Type-enum), [Color](qvariant.html#Type-enum), [Date](qvariant.html#Type-enum), [DateTime](qvariant.html#Type-enum), [Double](qvariant.html#Type-enum), [Font](qvariant.html#Type-enum), [Int](qvariant.html#Type-enum), [KeySequence](qvariant.html#Type-enum), [LongLong](qvariant.html#Type-enum), [StringList](qvariant.html#Type-enum), [Time](qvariant.html#Type-enum), [UInt](qvariant.html#Type-enum), [ULongLong](qvariant.html#Type-enum) | | [StringList](qvariant.html#Type-enum) | [List](qvariant.html#Type-enum), [String](qvariant.html#Type-enum) (if the list contains exactly one item) | | [Time](qvariant.html#Type-enum) | [String](qvariant.html#Type-enum) | | [UInt](qvariant.html#Type-enum) | [Bool](qvariant.html#Type-enum), [Char](qvariant.html#Type-enum), [Double](qvariant.html#Type-enum), [Int](qvariant.html#Type-enum), [LongLong](qvariant.html#Type-enum), [String](qvariant.html#Type-enum), [ULongLong](qvariant.html#Type-enum) | | [ULongLong](qvariant.html#Type-enum) | [Bool](qvariant.html#Type-enum), [Char](qvariant.html#Type-enum), [Double](qvariant.html#Type-enum), [Int](qvariant.html#Type-enum), [LongLong](qvariant.html#Type-enum), [String](qvariant.html#Type-enum), [UInt](qvariant.html#Type-enum) | **See also** [convert](qvariant.html#convert)（）。 ``` QVariant.clear (self) ``` 轉換這個變種輸入無效，并釋放使用的資源。 ``` bool QVariant.convert (self, Type?t) ``` 注塑變種所請求的類型，_t_。如果轉換無法完成，該變種被清除。返回True如果變量的當前類型已成功投，否則返回False 。 **Warning:**由于歷史的原因，將空[QVariant](qvariant.html)結果在所希望的類型（例如，一個空字符串的空值[QString](qstring.html)）和虛假的結果。 **See also** [canConvert](qvariant.html#canConvert)（）和[clear](qvariant.html#clear)（）。 ``` sip.voidptr QVariant.data (self) ``` ``` QVariant.detach (self) ``` ``` QVariant QVariant.fromList (list-of-QVariant?list) ``` ``` QVariant QVariant.fromMap (dict-of-QString-QVariant?map) ``` ``` bool QVariant.isDetached (self) ``` ``` bool QVariant.isNull (self) ``` 返回True如果這是一個空變量，否則返回False。 ``` bool QVariant.isValid (self) ``` 返回True如果這個變種的存儲類型是不[QVariant.Invalid](qvariant.html#Type-enum)否則返回False 。 ``` QVariant.load (self, QDataStream?ds) ``` ``` Type QVariant.nameToType (str?name) ``` [ 在給定的存儲類型的字符串表示形式轉換_name_，其枚舉表示。如果字符串表示不能轉換為任何枚舉表示，變量被設置為`Invalid`。 ``` QVariant.save (self, QDataStream?ds) ``` ``` QVariant.swap (self, QVariant?other) ``` 掉期變種_other_這種變體。這個操作是非常快的，而且永遠不會。此功能被引入Qt的4.8 。 ](index.htm#Type-enum) ``` QBitArray QVariant.toBitArray (self) ``` [](qbitarray.html) [返回變量作為](qbitarray.html)[QBitArray](qbitarray.html)如果該變體具有[type](qvariant.html#type)（）[BitArray](qvariant.html#Type-enum)否則返回一個空的位陣列。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` bool QVariant.toBool (self) ``` 返回變量為bool如果有變異[type](qvariant.html#type)（）布爾。如果變量有，則返回True[type](qvariant.html#type)（）[Bool](qvariant.html#Type-enum)，[Char](qvariant.html#Type-enum)，[Double](qvariant.html#Type-enum)，[Int](qvariant.html#Type-enum)，[LongLong](qvariant.html#Type-enum)，[UInt](qvariant.html#Type-enum)或[ULongLong](qvariant.html#Type-enum)和的值是非零，或者如果所述變體的類型為[String](qvariant.html#Type-enum) or [ByteArray](qvariant.html#Type-enum)和其小寫內容不為空， “0”或“假” ，否則返回假。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` QByteArray QVariant.toByteArray (self) ``` [](qbytearray.html) [返回變量作為](qbytearray.html)[QByteArray](qbytearray.html)如果該變體具有[type](qvariant.html#type)（）[ByteArray](qvariant.html#Type-enum) or [String](qvariant.html#Type-enum)使用（兌換[QString.fromAscii](qstring.html#fromAscii)（）），否則返回一個空字節數組。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` QChar QVariant.toChar (self) ``` 返回變量作為[QChar](qchar.html)如果該變體具有[type](qvariant.html#type)（）[Char](qvariant.html#Type-enum)，[Int](qvariant.html#Type-enum)或[UInt](qvariant.html#Type-enum)否則返回一個無效的[QChar](qchar.html)。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` QDate QVariant.toDate (self) ``` [](qdate.html) [返回變量作為](qdate.html)[QDate](qdate.html)如果該變體具有[type](qvariant.html#type)（）[Date](qvariant.html#Type-enum)，[DateTime](qvariant.html#Type-enum)或[String](qvariant.html#Type-enum)否則返回一個無效的日期。如果[type](qvariant.html#type)（）是[String](qvariant.html#Type-enum)，一個無效的日期，如果該字符串不能解析為一個將被退回[Qt.ISODate](qt.html#DateFormat-enum)格式的日期。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` QDateTime QVariant.toDateTime (self) ``` [](qdatetime.html) [返回變量作為](qdatetime.html)[QDateTime](qdatetime.html)如果該變體具有[type](qvariant.html#type)（）[DateTime](qvariant.html#Type-enum)，[Date](qvariant.html#Type-enum)或[String](qvariant.html#Type-enum)否則返回一個無效的日期/時間。如果[type](qvariant.html#type)（）是[String](qvariant.html#Type-enum)，一個無效的日期/時間，如果該字符串不能解析為一個將被退回[Qt.ISODate](qt.html#DateFormat-enum)格式的日期/時間。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` (float, bool?ok) QVariant.toDouble (self) ``` 返回變體作為雙如果所述變體具有[type](qvariant.html#type)（）[Double](qvariant.html#Type-enum)，[QMetaType.Float](qmetatype.html#Type-enum)，[Bool](qvariant.html#Type-enum)，[ByteArray](qvariant.html#Type-enum)，[Int](qvariant.html#Type-enum)，[LongLong](qvariant.html#Type-enum)，[String](qvariant.html#Type-enum)，[UInt](qvariant.html#Type-enum)或[ULongLong](qvariant.html#Type-enum)否則返回0.0 。 If _ok_不為null ：`*`_ok_被設置為True，如果該值可以轉換為double ，否則`*`_ok_設置為False 。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` QEasingCurve QVariant.toEasingCurve (self) ``` [](qeasingcurve.html) [返回變量作為](qeasingcurve.html)[QEasingCurve](qeasingcurve.html)如果該變體具有[type](qvariant.html#type)（）[EasingCurve](qvariant.html#Type-enum)否則返回一個默認的緩動曲線。此功能被引入Qt的4.7 。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` (float, bool?ok) QVariant.toFloat (self) ``` 返回變量為float ，如果該變體具有[type](qvariant.html#type)（）[Double](qvariant.html#Type-enum)，[QMetaType.Float](qmetatype.html#Type-enum)，[Bool](qvariant.html#Type-enum)，[ByteArray](qvariant.html#Type-enum)，[Int](qvariant.html#Type-enum)，[LongLong](qvariant.html#Type-enum)，[String](qvariant.html#Type-enum)，[UInt](qvariant.html#Type-enum)或[ULongLong](qvariant.html#Type-enum)否則返回0.0 。 If _ok_不為null ：`*`_ok_被設置為True，如果該值可以轉換為double ，否則`*`_ok_設置為False 。此功能被引入Qt的4.6 。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` dict-of-QString-QVariant QVariant.toHash (self) ``` 返回變量作為[QHash](index.htm)\u003c[QString](qstring.html)，[QVariant](qvariant.html)\u003e如果所述變體具有[type](qvariant.html#type)（）[Hash](qvariant.html#Type-enum)否則返回一個空映射。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` (int, bool?ok) QVariant.toInt (self) ``` 返回變量為int如果該變體具有[type](qvariant.html#type)（）[Int](qvariant.html#Type-enum)，[Bool](qvariant.html#Type-enum)，[ByteArray](qvariant.html#Type-enum)，[Char](qvariant.html#Type-enum)，[Double](qvariant.html#Type-enum)，[LongLong](qvariant.html#Type-enum)，[String](qvariant.html#Type-enum)，[UInt](qvariant.html#Type-enum)或[ULongLong](qvariant.html#Type-enum)否則返回0 。 If _ok_不為null ：`*`_ok_被設置為True，如果該值可以轉換為int ，否則`*`_ok_設置為False 。 **Warning:**如果該值可以轉換為一個[LongLong](qvariant.html#Type-enum)但過大的一個int來表示，由此產生的算術溢出將不會反映在_ok_。一個簡單的解決方法是使用[QString.toInt](qstring.html#toInt)（）。修復這個bug已經被推遲到5的Qt為了避免破壞現有的代碼。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` QLine QVariant.toLine (self) ``` [](qline.html) [返回變量作為](qline.html)[QLine](qline.html)如果該變體具有[type](qvariant.html#type)（）[Line](qvariant.html#Type-enum)否則返回一個無效的[QLine](qline.html)。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` QLineF QVariant.toLineF (self) ``` [](qlinef.html) [返回變量作為](qlinef.html)[QLineF](qlinef.html)如果該變體具有[type](qvariant.html#type)（）[LineF](qvariant.html#Type-enum)否則返回一個無效的[QLineF](qlinef.html)。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` list-of-QVariant QVariant.toList (self) ``` 返回變量作為[QVariantList](qvariant.html#QVariantList-typedef)如果該變體具有[type](qvariant.html#type)（）[List](qvariant.html#Type-enum) or [StringList](qvariant.html#Type-enum)否則返回空列表。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` QLocale QVariant.toLocale (self) ``` [](qlocale.html) [返回變量作為](qlocale.html)[QLocale](qlocale.html)如果該變體具有[type](qvariant.html#type)（）[Locale](qvariant.html#Type-enum)否則返回一個無效的[QLocale](qlocale.html)。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` (int, bool?ok) QVariant.toLongLong (self) ``` 返回變量為long long int的，如果有變異[type](qvariant.html#type)（）[LongLong](qvariant.html#Type-enum)，[Bool](qvariant.html#Type-enum)，[ByteArray](qvariant.html#Type-enum)，[Char](qvariant.html#Type-enum)，[Double](qvariant.html#Type-enum)，[Int](qvariant.html#Type-enum)，[String](qvariant.html#Type-enum)，[UInt](qvariant.html#Type-enum)或[ULongLong](qvariant.html#Type-enum)否則返回0 。 If _ok_不為null ：`*``ok`被設置為True，如果該值可以轉換為int ，否則`*``ok`設置為False 。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` dict-of-QString-QVariant QVariant.toMap (self) ``` 返回變量作為[QMap](index.htm)\u003c[QString](qstring.html)，[QVariant](qvariant.html)\u003e如果所述變體具有[type](qvariant.html#type)（）[Map](qvariant.html#Type-enum)否則返回一個空映射。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` QPoint QVariant.toPoint (self) ``` [](qpoint.html) [返回變量作為](qpoint.html)[QPoint](qpoint.html)如果該變體具有[type](qvariant.html#type)（）[Point](qvariant.html#Type-enum) or [PointF](qvariant.html#Type-enum)否則返回空[QPoint](qpoint.html)。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` QPointF QVariant.toPointF (self) ``` [](qpointf.html) [返回變量作為](qpointf.html)[QPointF](qpointf.html)如果該變體具有[type](qvariant.html#type)（）[Point](qvariant.html#Type-enum) or [PointF](qvariant.html#Type-enum)否則返回空[QPointF](qpointf.html)。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` object QVariant.toPyObject (self) ``` ``` (float, bool?ok) QVariant.toReal (self) ``` 返回變體作為QREAL如果??所述變體具有[type](qvariant.html#type)（）[Double](qvariant.html#Type-enum)，[QMetaType.Float](qmetatype.html#Type-enum)，[Bool](qvariant.html#Type-enum)，[ByteArray](qvariant.html#Type-enum)，[Int](qvariant.html#Type-enum)，[LongLong](qvariant.html#Type-enum)，[String](qvariant.html#Type-enum)，[UInt](qvariant.html#Type-enum)或[ULongLong](qvariant.html#Type-enum)否則返回0.0 。 If _ok_不為null ：`*`_ok_被設置為True，如果該值可以轉換為double ，否則`*`_ok_設置為False 。此功能被引入Qt的4.6 。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` QRect QVariant.toRect (self) ``` [](qrect.html) [返回變量作為](qrect.html)[QRect](qrect.html)如果該變體具有[type](qvariant.html#type)（）[Rect](qvariant.html#Type-enum)否則返回一個無效的[QRect](qrect.html)。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` QRectF QVariant.toRectF (self) ``` [](qrectf.html) [返回變量作為](qrectf.html)[QRectF](qrectf.html)如果該變體具有[type](qvariant.html#type)（）[Rect](qvariant.html#Type-enum) or [RectF](qvariant.html#Type-enum)否則返回一個無效的[QRectF](qrectf.html)。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` QRegExp QVariant.toRegExp (self) ``` [](qregexp.html) [返回變量作為](qregexp.html)[QRegExp](qregexp.html)如果該變體具有[type](qvariant.html#type)（）[RegExp](qvariant.html#Type-enum)否則返回一個空[QRegExp](qregexp.html)。這個函數是Qt 4.1中引入。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` QSize QVariant.toSize (self) ``` [](qsize.html) [返回變量作為](qsize.html)[QSize](qsize.html)如果該變體具有[type](qvariant.html#type)（）[Size](qvariant.html#Type-enum)否則返回一個無效的[QSize](qsize.html)。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` QSizeF QVariant.toSizeF (self) ``` [](qsizef.html) [返回變量作為](qsizef.html)[QSizeF](qsizef.html)如果該變體具有[type](qvariant.html#type)（）[SizeF](qvariant.html#Type-enum)否則返回一個無效的[QSizeF](qsizef.html)。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` QString QVariant.toString (self) ``` 返回變量作為[QString](qstring.html)如果該變體具有[type](qvariant.html#type)（）[String](qvariant.html#Type-enum)，[Bool](qvariant.html#Type-enum)，[ByteArray](qvariant.html#Type-enum)，[Char](qvariant.html#Type-enum)，[Date](qvariant.html#Type-enum)，[DateTime](qvariant.html#Type-enum)，[Double](qvariant.html#Type-enum)，[Int](qvariant.html#Type-enum)，[LongLong](qvariant.html#Type-enum)，[StringList](qvariant.html#Type-enum)，[Time](qvariant.html#Type-enum)，[UInt](qvariant.html#Type-enum)或[ULongLong](qvariant.html#Type-enum)否則返回一個空字符串。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` QStringList QVariant.toStringList (self) ``` 返回變量作為[QStringList](qstringlist.html)如果該變體具有[type](qvariant.html#type)（）[StringList](qvariant.html#Type-enum)，[String](qvariant.html#Type-enum)或[List](qvariant.html#Type-enum)這可以轉換為一個類型的[QString](qstring.html)否則返回空列表。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` QTime QVariant.toTime (self) ``` [](qtime.html) [返回變量作為](qtime.html)[QTime](qtime.html)如果該變體具有[type](qvariant.html#type)（）[Time](qvariant.html#Type-enum)，[DateTime](qvariant.html#Type-enum)或[String](qvariant.html#Type-enum)否則返回一個無效的時間。如果[type](qvariant.html#type)（）是[String](qvariant.html#Type-enum)，一個無效的時間，如果該字符串不能解析為一個將被退回[Qt.ISODate](qt.html#DateFormat-enum)格式時間。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` (int, bool?ok) QVariant.toUInt (self) ``` 返回變量為一個unsigned int如果該變體具有[type](qvariant.html#type)（）[UInt](qvariant.html#Type-enum)，[Bool](qvariant.html#Type-enum)，[ByteArray](qvariant.html#Type-enum)，[Char](qvariant.html#Type-enum)，[Double](qvariant.html#Type-enum)，[Int](qvariant.html#Type-enum)，[LongLong](qvariant.html#Type-enum)，[String](qvariant.html#Type-enum)或[ULongLong](qvariant.html#Type-enum)否則返回0 。 If _ok_不為null ：`*`_ok_被設置為True，如果該值可以轉換為一個unsigned int ，否則`*`_ok_設置為False 。 **Warning:**如果該值可以轉換為一個[ULongLong](qvariant.html#Type-enum)但過大的一個unsigned int來表示，由此產生的算術溢出將不會反映在_ok_。一個簡單的解決方法是使用[QString.toUInt](qstring.html#toUInt)（）。修復這個bug已經被推遲到5的Qt為了避免破壞現有的代碼。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` (int, bool?ok) QVariant.toULongLong (self) ``` 返回變體為unsigned long long int的，如果有變異[type](qvariant.html#type)（）[ULongLong](qvariant.html#Type-enum)，[Bool](qvariant.html#Type-enum)，[ByteArray](qvariant.html#Type-enum)，[Char](qvariant.html#Type-enum)，[Double](qvariant.html#Type-enum)，[Int](qvariant.html#Type-enum)，[LongLong](qvariant.html#Type-enum)，[String](qvariant.html#Type-enum)或[UInt](qvariant.html#Type-enum)否則返回0 。 If _ok_不為null ：`*`_ok_被設置為True，如果該值可以轉換為int ，否則`*`_ok_設置為False 。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` QUrl QVariant.toUrl (self) ``` [](qurl.html) [返回變量作為](qurl.html)[QUrl](qurl.html)如果該變體具有[type](qvariant.html#type)（）[Url](qvariant.html#Type-enum)否則返回一個無效的[QUrl](qurl.html)。 **See also** [canConvert](qvariant.html#canConvert)（）和[convert](qvariant.html#convert)（）。 ``` Type QVariant.type (self) ``` [](index.htm#Type-enum) [返回存儲在變量值的存儲類型。雖然這個函數被聲明為返回](index.htm#Type-enum)[QVariant.Type](qvariant.html#Type-enum)，返回值應解釋為[QMetaType.Type](qmetatype.html#Type-enum)。特別地，[QVariant.UserType](qvariant.html#Type-enum)這里只返回該值是否等于或大于[QMetaType.User](qmetatype.html#Type-enum)。請注意，在該范圍內的返回值[QVariant.Char](qvariant.html#Type-enum)通過[QVariant.RegExp](qvariant.html#Type-enum)和[QVariant.Font](qvariant.html#Type-enum)通過[QVariant.Transform](qvariant.html#Type-enum)對應于在范圍中的值[QMetaType.QChar](qmetatype.html#Type-enum)通過[QMetaType.QRegExp](qmetatype.html#Type-enum)和[QMetaType.QFont](qmetatype.html#Type-enum)通過[QMetaType.QQuaternion](qmetatype.html#Type-enum)。用char工作時，要特別注意和[QChar](qchar.html)變種。需要注意的是，沒有[QVariant](qvariant.html)構造函數專門為char類型，但有一個用于[QChar](qchar.html)。對于類型的變體[QChar](qchar.html)，這個函數返回[QVariant.Char](qvariant.html#Type-enum)，這是相同的[QMetaType.QChar](qmetatype.html#Type-enum)，但是對于類型的變體`char`，這個函數返回[QMetaType.Char](qmetatype.html#Type-enum)，這是_not_一樣[QVariant.Char](qvariant.html#Type-enum)。還要注意的是類型`void*`，`long`，`short`，`unsigned` `long`，`unsigned` `short`，`unsigned` `char`，`float`，`QObject*`和`QWidget*`都派代表參加[QMetaType.Type](qmetatype.html#Type-enum)但不是在[QVariant.Type](qvariant.html#Type-enum)，并且它們可以由該函數返回。然而，它們都被認為是用戶定義的類型時，對測試[QVariant.Type](qvariant.html#Type-enum)。為了測試是否實例[QVariant](qvariant.html)包含與你感興趣的數據類型，使用兼容的數據類型[canConvert](qvariant.html#canConvert)（）。 ``` str QVariant.typeName (self) ``` 返回存儲在所述變體的類型的名稱。返回的字符串描述了C + +的數據類型來存儲數據：例如， “[QFont](qfont.html)“，”[QString](qstring.html)“或”[QVariantList](qvariant.html#QVariantList-typedef)“一個無效的變量返回0 。 ``` str QVariant.typeToName (Type?type) ``` 存儲類型的枚舉表示轉換，_typ_，其字符串表示形式。返回一個空指針的類型是[QVariant.Invalid](qvariant.html#Type-enum)或不存在。 ``` int QVariant.userType (self) ``` 返回存儲在變量值的存儲類型。對于非用戶類型，這是相同的[type](qvariant.html#type)（）。 **See also** [type](qvariant.html#type)（）。 ``` bool QVariant.__eq__ (self, QVariant?v) ``` ``` bool QVariant.__ne__ (self, QVariant?v) ```