QScriptValue Class Reference · PyQt4 中文文檔

# QScriptValue Class Reference ## [[QtScript](index.htm) module] 該QScriptValue類作為一個容器Qt的腳本數據類型。[More...](#details) ### Types * `enum PropertyFlag { ReadOnly, Undeletable, SkipInEnumeration, PropertyGetter, ..., UserRange }` * `class **[PropertyFlags](index.htm)**` * `enum ResolveFlag { ResolveLocal, ResolvePrototype, ResolveScope, ResolveFull }` * `class **[ResolveFlags](index.htm)**` * `enum SpecialValue { NullValue, UndefinedValue }` ### Methods * `__init__ (self)` * `__init__ (self, QScriptValue?other)` * `__init__ (self, SpecialValue?value)` * `__init__ (self, QScriptEngine?engine, SpecialValue?val)` * `__init__ (self, bool?value)` * `__init__ (self, QScriptEngine?engine, bool?val)` * `__init__ (self, int?value)` * `__init__ (self, QScriptEngine?engine, int?val)` * `__init__ (self, float?value)` * `__init__ (self, QScriptEngine?engine, float?val)` * `__init__ (self, QString?value)` * `__init__ (self, QScriptEngine?engine, QString?val)` * `QScriptValue call (self, QScriptValue?thisObject?=?QScriptValue(), list-of-QScriptValue?args?=?QScriptValueList())` * `QScriptValue call (self, QScriptValue?thisObject, QScriptValue?arguments)` * `QScriptValue construct (self, list-of-QScriptValue?args?=?QScriptValueList())` * `QScriptValue construct (self, QScriptValue?arguments)` * `QScriptValue data (self)` * `QScriptEngine engine (self)` * `bool equals (self, QScriptValue?other)` * `bool instanceOf (self, QScriptValue?ctor)` * `bool isArray (self)` * `bool isBool (self)` * `bool isBoolean (self)` * `bool isDate (self)` * `bool isError (self)` * `bool isFunction (self)` * `bool isNull (self)` * `bool isNumber (self)` * `bool isObject (self)` * `bool isQMetaObject (self)` * `bool isQObject (self)` * `bool isRegExp (self)` * `bool isString (self)` * `bool isUndefined (self)` * `bool isValid (self)` * `bool isVariant (self)` * `bool lessThan (self, QScriptValue?other)` * `QScriptValue property (self, QString?name, ResolveFlags?mode?=?QScriptValue.ResolvePrototype)` * `QScriptValue property (self, QScriptString?name, ResolveFlags?mode?=?QScriptValue.ResolvePrototype)` * `QScriptValue property (self, int?arrayIndex, ResolveFlags?mode?=?QScriptValue.ResolvePrototype)` * `PropertyFlags propertyFlags (self, QString?name, ResolveFlags?mode?=?QScriptValue.ResolvePrototype)` * `PropertyFlags propertyFlags (self, QScriptString?name, ResolveFlags?mode?=?QScriptValue.ResolvePrototype)` * `QScriptValue prototype (self)` * `QScriptClass scriptClass (self)` * `setData (self, QScriptValue?data)` * `setProperty (self, QString?name, QScriptValue?value, PropertyFlags?flags?=?QScriptValue.KeepExistingFlags)` * `setProperty (self, QScriptString?name, QScriptValue?value, PropertyFlags?flags?=?QScriptValue.KeepExistingFlags)` * `setProperty (self, int?arrayIndex, QScriptValue?value, PropertyFlags?flags?=?QScriptValue.KeepExistingFlags)` * `setPrototype (self, QScriptValue?prototype)` * `setScriptClass (self, QScriptClass?scriptClass)` * `bool strictlyEquals (self, QScriptValue?other)` * `bool toBool (self)` * `bool toBoolean (self)` * `QDateTime toDateTime (self)` * `int toInt32 (self)` * `float toInteger (self)` * `float toNumber (self)` * `QScriptValue toObject (self)` * `QMetaObject toQMetaObject (self)` * `QObject toQObject (self)` * `QRegExp toRegExp (self)` * `QString toString (self)` * `int toUInt16 (self)` * `int toUInt32 (self)` * `QVariant toVariant (self)` * * * ## Detailed Description 該QScriptValue類作為一個容器Qt的腳本數據類型。 QScriptValue支持在中定義的類型 [ECMA-262](http://www.ecma-international.org/publications/standards/Ecma-262.htm)標準：基元類型，它是未定義，為null ，布爾，數字和字符串;和對象類型。此外， Qt的腳本有內置的支持[QVariant](qvariant.html)，[QObject](qobject.html)和[QMetaObject](qmetaobject.html)。對于基于對象類型（包括Date和RegExp ），使用NEWT （）函數[QScriptEngine](qscriptengine.html)（例如[QScriptEngine.newObject](qscriptengine.html#newObject)（））來創建所需類型的QScriptValue 。對于原始類型，使用QScriptValue構造函數重載之一。命名為T （）的方法（例如[isBool](qscriptvalue.html#isBool)（）[isUndefined](qscriptvalue.html#isUndefined)（））可以被用來測試一個值是否是特定類型的。命名為TOT （）方法（例如[toBool](qscriptvalue.html#toBool)（）[toString](qscriptvalue.html#toString)()) can be used to convert a QScriptValue to another type. You can also use the generic [qscriptvalue_cast](qscriptvalue.html#qscriptvalue_cast)() function. Object values have zero or more properties which are themselves QScriptValues. Use [setProperty](qscriptvalue.html#setProperty)() to set a property of an object, and call [property](qscriptvalue.html#property)() to retrieve the value of a property. ``` [QScriptEngine](qscriptengine.html) myEngine; QScriptValue myObject = myEngine.newObject(); QScriptValue myOtherObject = myEngine.newObject(); myObject.setProperty("myChild", myOtherObject); myObject.setProperty("name", "John Doe"); ``` Each property can have a set of attributes; these are specified as the third (optional) argument to [setProperty](qscriptvalue.html#setProperty)(). The attributes of a property can be queried by calling the [propertyFlags](qscriptvalue.html#propertyFlags)() function. The following code snippet creates a property that cannot be modified by script code: ``` QScriptValue val(&myEngine, 123); myObject.setProperty("myReadOnlyProperty", val, QScriptValue.ReadOnly); ``` 如果你想遍歷一個腳本對象的屬性，使用[QScriptValueIterator](qscriptvalueiterator.html)類。對象的值有一個內部`prototype`屬性，該屬性可以被訪問[prototype](qscriptvalue.html#prototype)（）和[setPrototype](qscriptvalue.html#setPrototype)（）。屬性添加到原型由具有該原型中的所有對象共享，這被稱為基于原型的繼承。在實踐中，這意味著（默認）的[property](qscriptvalue.html#property)（）函數將自動嘗試查找看在財產[prototype](qscriptvalue.html#prototype)（）（和的原型[prototype](qscriptvalue.html#prototype)（），等等），如果對象本身不具有所需的特性。請注意，不是由執行這個原型基于查找[setProperty](qscriptvalue.html#setProperty)（）;[setProperty](qscriptvalue.html#setProperty)（）總是會在腳本對象本身創造的財產。欲了解更多信息，請參閱[QtScript](index.htm)文檔。函數對象（對象的[isFunction](qscriptvalue.html#isFunction)（）返回True ）可以通過調用來調用[call](qscriptvalue.html#call)（）。構造函數可以用來構造新的對象通過調用[construct](qscriptvalue.html#construct)（）。使用[equals](qscriptvalue.html#equals)（）[strictlyEquals](qscriptvalue.html#strictlyEquals)（）和[lessThan](qscriptvalue.html#lessThan)（）到QScriptValue比較到另一個。對象的值可以有與它們相關聯的自定義數據，見[setData](qscriptvalue.html#setData)（）和[data](qscriptvalue.html#data)（）函數。默認情況下，這個數據是不可訪問的腳本，它可以用來存儲你想要用腳本對象相關聯的任何數據。通常，這是通過使用自定義類對象（見[QScriptClass](qscriptclass.html)）來存儲一個C + +類，它包含了“原生”對象數據。請注意，一個QScriptValue的量[isObject](qscriptvalue.html#isObject)（）是真實的，只有帶有一個參考的實際對象;復制QScriptValue將只復制對象的引用，而不是對象本身。如果你想克隆一個對象（即一個對象的屬性復制到另一個對象），你可以用一個幫助做`for-in`聲明腳本代碼，或[QScriptValueIterator](qscriptvalueiterator.html)在C + + 。 * * * ## Type Documentation ``` QScriptValue.PropertyFlag ``` 這個枚舉描述屬性的特性。 | Constant | Value | Description | | --- | --- | --- | | `QScriptValue.ReadOnly` | `0x00000001` | 該屬性是只讀的。通過Qt的腳本代碼試圖寫入該屬性將被忽略。 | | `QScriptValue.Undeletable` | `0x00000002` | 試圖通過Qt的腳本代碼`delete`該屬性將被忽略。 | | `QScriptValue.SkipInEnumeration` | `0x00000004` | 該物業不能由一個枚舉`for-in`枚舉。 | | `QScriptValue.PropertyGetter` | `0x00000008` | 該物業由一個將被調用來獲得屬性值函數定義。 | | `QScriptValue.PropertySetter` | `0x00000010` | 該物業由一個將被調用來設置屬性值函數定義。 | 這個標志被用于表示一個現有的屬性是一個[QObject](qobject.html)成員（屬性或方法）。 | Constant | Value | Description | | --- | --- | --- | | `QScriptValue.KeepExistingFlags` | `0x00000800` | 這個值被用來表示[setProperty](qscriptvalue.html#setProperty)（）該物業的標志應保持不變。如果屬性不存在，則默認標志（ 0 ）將被使用。 | 標志在此范圍內不使用Qt的腳本，并且可以用于定制的目的。該PropertyFlags類型是一個typedef為[QFlags](index.htm)\u003cPropertyFlag\u003e 。它存儲PropertyFlag值的或組合。 ``` QScriptValue.ResolveFlag ``` 此枚舉指定如何查找某個對象的屬性。 | Constant | Value | Description | | --- | --- | --- | | `QScriptValue.ResolveLocal` | `0x00` | 只檢查對象自己的屬性。 | | `QScriptValue.ResolvePrototype` | `0x01` | 檢查對象本身的屬性，然后再搜索原型鏈。這是默認的。 | 檢查對象本身的屬性，然后再搜索作用域鏈。檢查對象本身的屬性，然后再搜索原型鏈，最后搜索的作用域鏈。該ResolveFlags類型是一個typedef為[QFlags](index.htm)\u003cResolveFlag\u003e 。它存儲ResolveFlag值的或組合。 ``` QScriptValue.SpecialValue ``` 此枚舉用于指定一個單值類型。 | Constant | Value | Description | | --- | --- | --- | | `QScriptValue.UndefinedValue` | `1` | 一個未定義的值。 | | `QScriptValue.NullValue` | `0` | null值。 | * * * ## Method Documentation ``` QScriptValue.__init__ (self) ``` 構造一個無效的[QScriptValue](qscriptvalue.html)。 ``` QScriptValue.__init__ (self, QScriptValue?other) ``` 構造一個新的[QScriptValue](qscriptvalue.html)即副本_other_。注意，如果_other_本發明的目的（即，[isObject](qscriptvalue.html#isObject)（）將返回True ），那么只有一個參照相關對象被復制到新的腳本值（即，對象本身不會被復制）。 ``` QScriptValue.__init__ (self, SpecialValue?value) ``` ``` QScriptValue.__init__ (self, QScriptEngine?engine, SpecialValue?val) ``` ``` QScriptValue.__init__ (self, bool?value) ``` ``` QScriptValue.__init__ (self, QScriptEngine?engine, bool?val) ``` ``` QScriptValue.__init__ (self, int?value) ``` ``` QScriptValue.__init__ (self, QScriptEngine?engine, int?val) ``` ``` QScriptValue.__init__ (self, float?value) ``` ``` QScriptValue.__init__ (self, QScriptEngine?engine, float?val) ``` 構造一個新的[QScriptValue](qscriptvalue.html)用特別的_value_。此功能被引入Qt的4.5 。 ``` QScriptValue.__init__ (self, QString?value) ``` 構造一個新的[QScriptValue](qscriptvalue.html)用布爾_value_。此功能被引入Qt的4.5 。 ``` QScriptValue.__init__ (self, QScriptEngine?engine, QString?val) ``` 構造一個新的[QScriptValue](qscriptvalue.html)以數字_value_。此功能被引入Qt的4.5 。 ``` QScriptValue QScriptValue.call (self, QScriptValue?thisObject?=?QScriptValue(), list-of-QScriptValue?args?=?QScriptValueList()) ``` [](qscriptvalue.html) [調用此](qscriptvalue.html)[QScriptValue](qscriptvalue.html)作為一個功能，用_thisObject_在函數調用中的' this'對象，并通過_args_作為參數傳遞給函數。返回從函數返回的值。如果這[QScriptValue](qscriptvalue.html)是不是一個函數，調用（）不執行任何操作，并返回一個無效的[QScriptValue](qscriptvalue.html)。注意，如果_thisObject_是不是一個對象，全局對象（見[QScriptEngine.globalObject](qscriptengine.html#globalObject)（））將被用作`這個'對象。調用調用（）可能會導致異常發生在腳本引擎，在這種情況下，（）調用返回拋出的值（通常是`Error`對象）。您可以致電[QScriptEngine.hasUncaughtException](qscriptengine.html#hasUncaughtException)（），以確定是否發生了異常。 ``` [QScriptEngine](qscriptengine.html) engine; engine.evaluate("function fullName() { return this.firstName + ' ' + this.lastName; }"); engine.evaluate("somePerson = { firstName: 'John', lastName: 'Doe' }"); [QScriptValue](qscriptvalue.html) global = engine.globalObject(); [QScriptValue](qscriptvalue.html) fullName = global.property("fullName"); [QScriptValue](qscriptvalue.html) who = global.property("somePerson"); qDebug() << fullName.call(who).toString(); // "John Doe" engine.evaluate("function cube(x) { return x * x * x; }"); [QScriptValue](qscriptvalue.html) cube = global.property("cube"); QScriptValueList args; args << 3; qDebug() << cube.call([QScriptValue](qscriptvalue.html)(), args).toNumber(); // 27 ``` **See also** [construct](qscriptvalue.html#construct)（）。 ``` QScriptValue QScriptValue.call (self, QScriptValue?thisObject, QScriptValue?arguments) ``` [](qscriptvalue.html) [調用此](qscriptvalue.html)[QScriptValue](qscriptvalue.html)作為一個功能，用_thisObject_在函數調用中的' this'對象，并通過_arguments_作為參數傳遞給函數。返回從函數返回的值。如果這[QScriptValue](qscriptvalue.html)不是一個函數，[call](qscriptvalue.html#call)（）不執行任何操作，并返回一個無效的[QScriptValue](qscriptvalue.html)。 _arguments_可以是一個參數對象，數組， null或undefined ;任何其他類型將導致一個TypeError異常被拋出。注意，如果_thisObject_是不是一個對象，全局對象（見[QScriptEngine.globalObject](qscriptengine.html#globalObject)（））將被用作`這個'對象。這個功能的一個常見用法是原生函數調用轉發到另一個函數： ``` [QScriptValue](qscriptvalue.html) myNativeFunction([QScriptContext](qscriptcontext.html) *ctx, [QScriptEngine](qscriptengine.html) *) { [QScriptValue](qscriptvalue.html) otherFunction = ...; return otherFunction.call(ctx->thisObject(), ctx->argumentsObject()); } ``` **See also** [construct](qscriptvalue.html#construct)（）和[QScriptContext.argumentsObject](qscriptcontext.html#argumentsObject)（）。 ``` QScriptValue QScriptValue.construct (self, list-of-QScriptValue?args?=?QScriptValueList()) ``` [](qscriptvalue.html) [創建一個新的`Object`并調用這個](qscriptvalue.html)[QScriptValue](qscriptvalue.html)作為一個構造函數，使用創建的對象作為` this'對象和傳球_args_作為參數。如果從構造函數調用的返回值是一個對象，則該對象被返回，否則默認的構造的對象返回。如果這[QScriptValue](qscriptvalue.html)是不是一個函數，構造（）不執行任何操作，并返回一個無效的[QScriptValue](qscriptvalue.html)。調用構造（）可能會導致異常發生在腳本引擎，在這種情況下，構建（）返回一個被拋出（通常是一個值`Error`對象）。您可以致電[QScriptEngine.hasUncaughtException](qscriptengine.html#hasUncaughtException)（），以確定是否發生了異常。 **See also** [call](qscriptvalue.html#call)（）和[QScriptEngine.newObject](qscriptengine.html#newObject)（）。 ``` QScriptValue QScriptValue.construct (self, QScriptValue?arguments) ``` [](qscriptvalue.html) [創建一個新的`Object`并調用這個](qscriptvalue.html)[QScriptValue](qscriptvalue.html)作為一個構造函數，使用創建的對象作為` this'對象和傳球_arguments_作為參數。如果從構造函數調用的返回值是一個對象，則該對象被返回，否則默認的構造的對象返回。如果這[QScriptValue](qscriptvalue.html)不是一個函數，[construct](qscriptvalue.html#construct)（）不執行任何操作，并返回一個無效的[QScriptValue](qscriptvalue.html)。 _arguments_可以是一個參數對象，數組， null或undefined 。任何其他類型將導致一個TypeError異常被拋出。 **See also** [call](qscriptvalue.html#call)（）[QScriptEngine.newObject](qscriptengine.html#newObject)（）和[QScriptContext.argumentsObject](qscriptcontext.html#argumentsObject)（）。 ``` QScriptValue QScriptValue.data (self) ``` [](qscriptvalue.html) [返回此內部數據](qscriptvalue.html)[QScriptValue](qscriptvalue.html)對象。[QtScript](index.htm)使用這個屬性來存儲日期，字符串，數字和布爾對象的原始值。對于其他類型的對象，自定義數據可以使用存儲[setData](qscriptvalue.html#setData)（）。此功能被引入Qt的4.4 。 **See also** [setData](qscriptvalue.html#setData)（）。 ``` QScriptEngine QScriptValue.engine (self) ``` [](qscriptengine.html) [返回](qscriptengine.html)[QScriptEngine](qscriptengine.html)創建此[QScriptValue](qscriptvalue.html)，或者0 ，如果這[QScriptValue](qscriptvalue.html)無效或值不與特定的發動機相關聯。 ``` bool QScriptValue.equals (self, QScriptValue?other) ``` 返回True如果[QScriptValue](qscriptvalue.html)等于_other_，否則返回False 。比較如下所述的行為 [ECMA-262](http://www.ecma-international.org/publications/standards/Ecma-262.htm)11.9.3節， “抽象相等比較算法” 。這個函數可以返回真實的，即使這種類型[QScriptValue](qscriptvalue.html)是的類型不同_other_值，即比較不嚴格。例如， 9號比較字符串“ 9”返回True ;一個未定義的值進行比較，以空值返回True ;一個比較`Number`對象，其原始值是6到`String`對象，其原始值“6”返回True ;和數字1比較的布爾值`true`返回True。如果你想執行一個比較沒有這樣的隱式數值轉換，使用[strictlyEquals](qscriptvalue.html#strictlyEquals)（）。注意，如果這個[QScriptValue](qscriptvalue.html)或_other_值是對象，調用這個函數對腳本引擎的副作用，因為引擎會調用對象的valueOf（）的函數（也可能[toString](qscriptvalue.html#toString)（）），試圖將對象轉換為原始值（可能導致一個未捕獲的腳本異常）。 **See also** [strictlyEquals](qscriptvalue.html#strictlyEquals)（）和[lessThan](qscriptvalue.html#lessThan)（）。 ``` bool QScriptValue.instanceOf (self, QScriptValue?ctor) ``` 返回True如果[QScriptValue](qscriptvalue.html)是的一個實例_other_否則返回False 。 This [QScriptValue](qscriptvalue.html)被認為是一個實例_other_如果_other_是一個函數和的值`prototype`物業_other_是在原型的這條產業鏈[QScriptValue](qscriptvalue.html)。 ``` bool QScriptValue.isArray (self) ``` 返回True如果[QScriptValue](qscriptvalue.html)是Array類的一個對象，否則返回False 。 **See also** [QScriptEngine.newArray](qscriptengine.html#newArray)（）。 ``` bool QScriptValue.isBool (self) ``` 返回True如果[QScriptValue](qscriptvalue.html)是原始的Boolean類型，否則返回False 。此功能被引入Qt的4.5 。 **See also** [toBool](qscriptvalue.html#toBool)（）。 ``` bool QScriptValue.isBoolean (self) ``` ``` bool QScriptValue.isDate (self) ``` 返回True如果[QScriptValue](qscriptvalue.html)是Date類的一個對象，否則返回False 。 **See also** [QScriptEngine.newDate](qscriptengine.html#newDate)（）。 ``` bool QScriptValue.isError (self) ``` 返回True如果[QScriptValue](qscriptvalue.html)是Error類的一個對象，否則返回False 。 **See also** [QScriptContext.throwError](qscriptcontext.html#throwError)（）。 ``` bool QScriptValue.isFunction (self) ``` 返回True如果[QScriptValue](qscriptvalue.html)是一個函數，否則返回False 。 **See also** [call](qscriptvalue.html#call)（）。 ``` bool QScriptValue.isNull (self) ``` 返回True如果[QScriptValue](qscriptvalue.html)是原始類型的Null ;否則返回False。 **See also** [QScriptEngine.nullValue](qscriptengine.html#nullValue)（）。 ``` bool QScriptValue.isNumber (self) ``` 返回True如果[QScriptValue](qscriptvalue.html)是的基本類型數，否則返回False 。 **See also** [toNumber](qscriptvalue.html#toNumber)（）。 ``` bool QScriptValue.isObject (self) ``` 返回True如果[QScriptValue](qscriptvalue.html)是Object類型，否則返回False 。需要注意的是函數值，變量值和[QObject](qobject.html)值是對象，所以對于這樣的值該函數返回True 。 **See also** [toObject](index.htm#toObject)（）和[QScriptEngine.newObject](qscriptengine.html#newObject)（）。 ``` bool QScriptValue.isQMetaObject (self) ``` 返回True如果[QScriptValue](qscriptvalue.html)是[QMetaObject](qmetaobject.html)否則返回False 。 **See also** [toQMetaObject](qscriptvalue.html#toQMetaObject)（）和[QScriptEngine.newQMetaObject](qscriptengine.html#newQMetaObject)（）。 ``` bool QScriptValue.isQObject (self) ``` 返回True如果[QScriptValue](qscriptvalue.html)是[QObject](qobject.html)否則返回False 。注意：這個函數返回True ，即使[QObject](qobject.html)這[QScriptValue](qscriptvalue.html)包裹已被刪除。 **See also** [toQObject](qscriptvalue.html#toQObject)（）和[QScriptEngine.newQObject](qscriptengine.html#newQObject)（）。 ``` bool QScriptValue.isRegExp (self) ``` 返回True如果[QScriptValue](qscriptvalue.html)是設置了RegExp類的一個對象，否則返回False 。 **See also** [QScriptEngine.newRegExp](qscriptengine.html#newRegExp)（）。 ``` bool QScriptValue.isString (self) ``` 返回True如果[QScriptValue](qscriptvalue.html)是原始類型為String ，否則返回False 。 **See also** [toString](qscriptvalue.html#toString)（）。 ``` bool QScriptValue.isUndefined (self) ``` 返回True如果[QScriptValue](qscriptvalue.html)是未定義的原始類型，否則返回False 。 **See also** [QScriptEngine.undefinedValue](qscriptengine.html#undefinedValue)（）。 ``` bool QScriptValue.isValid (self) ``` 返回True如果[QScriptValue](qscriptvalue.html)是有效的，否則返回False 。 ``` bool QScriptValue.isVariant (self) ``` 返回True如果[QScriptValue](qscriptvalue.html)是一個變量的值，否則返回False 。 **See also** [toVariant](qscriptvalue.html#toVariant)（）和[QScriptEngine.newVariant](qscriptengine.html#newVariant)（）。 ``` bool QScriptValue.lessThan (self, QScriptValue?other) ``` 返回True如果[QScriptValue](qscriptvalue.html)小于_other_，否則返回False 。比較如下所述的行為 [ECMA-262](http://www.ecma-international.org/publications/standards/Ecma-262.htm)11.8.5節， “抽象關系比較算法” 。注意，如果這個[QScriptValue](qscriptvalue.html)或_other_值是對象，調用這個函數對腳本引擎的副作用，因為引擎會調用對象的valueOf（）的函數（也可能[toString](qscriptvalue.html#toString)（）），試圖將對象轉換為原始值（可能導致一個未捕獲的腳本異常）。 **See also** [equals](qscriptvalue.html#equals)（）。 ``` QScriptValue QScriptValue.property (self, QString?name, ResolveFlags?mode?=?QScriptValue.ResolvePrototype) ``` [](qscriptvalue.html) [返回此值](qscriptvalue.html)[QScriptValue](qscriptvalue.html)的屬性與給定的_name_，使用給定的_mode_為解決該房產。如果沒有這樣的屬性存在，無效[QScriptValue](qscriptvalue.html)返回。如果屬性是使用一個getter函數實現的（即有[PropertyGetter](qscriptvalue.html#PropertyFlag-enum)標志設置），要求財產（）對腳本引擎的副作用，因為getter函數將被調用（可能導致一個未捕獲的腳本異常）。如果發生異常，財產（）返回被拋出（通常是一個值`Error`對象）。 **See also** [setProperty](qscriptvalue.html#setProperty)（）[propertyFlags](qscriptvalue.html#propertyFlags)（）和[QScriptValueIterator](qscriptvalueiterator.html)。 ``` QScriptValue QScriptValue.property (self, QScriptString?name, ResolveFlags?mode?=?QScriptValue.ResolvePrototype) ``` [](qscriptvalue.html) [返回此值](qscriptvalue.html)[QScriptValue](qscriptvalue.html)的屬性與給定的_name_，使用給定的_mode_為解決該房產。這種超負荷[property](qscriptvalue.html#property)當你需要查找同一個屬性重復，因為查詢的速度就會加快，當名字被表示為一個字符串實習（）是非常有用的。此功能被引入Qt的4.4 。 **See also** [QScriptEngine.toStringHandle](qscriptengine.html#toStringHandle)（）和[setProperty](qscriptvalue.html#setProperty)（）。 ``` QScriptValue QScriptValue.property (self, int?arrayIndex, ResolveFlags?mode?=?QScriptValue.ResolvePrototype) ``` [ 這是一個重載函數。返回屬性在給定_arrayIndex_，使用給定的_mode_為解決該房產。此功能與數組對象時提供了方便和性能。 ](qscriptvalue.html) [如果這](qscriptvalue.html)[QScriptValue](qscriptvalue.html)是不是一個Array對象，這個函數的行為就像[property](qscriptvalue.html#property)（）被調用的字符串表示形式_arrayIndex_。 ``` PropertyFlags QScriptValue.propertyFlags (self, QString?name, ResolveFlags?mode?=?QScriptValue.ResolvePrototype) ``` [ 返回屬性的標志與給定_name_，使用給定的_mode_為解決該房產。 ](index.htm) [**See also**](index.htm) [property](qscriptvalue.html#property)（）。 ``` PropertyFlags QScriptValue.propertyFlags (self, QScriptString?name, ResolveFlags?mode?=?QScriptValue.ResolvePrototype) ``` [ 返回屬性的標志與給定_name_，使用給定的_mode_為解決該房產。此功能被引入Qt的4.4 。 ](index.htm) [**See also**](index.htm) [property](qscriptvalue.html#property)（）。 ``` QScriptValue QScriptValue.prototype (self) ``` [](qscriptvalue.html) [如果這](qscriptvalue.html)[QScriptValue](qscriptvalue.html)是一個對象，返回內部原型（`__proto__`此對象的屬性），否則返回一個無效的[QScriptValue](qscriptvalue.html)。 **See also** [setPrototype](qscriptvalue.html#setPrototype)（）和[isObject](qscriptvalue.html#isObject)（）。 ``` QScriptClass QScriptValue.scriptClass (self) ``` [ 返回自定義類的腳本，此腳本對象的一個實例，或者0，如果對象是一個自定義類的沒有。此功能被引入Qt的4.4 。 ](qscriptclass.html) [**See also**](qscriptclass.html) [setScriptClass](qscriptvalue.html#setScriptClass)（）。 ``` QScriptValue.setData (self, QScriptValue?data) ``` 設置內部_data_這[QScriptValue](qscriptvalue.html)對象。您可以使用此功能來設置，將不會直接訪問腳本對象的具體數據，但可以檢索在C + +中使用[data](qscriptvalue.html#data)（）函數。此功能被引入Qt的4.4 。 **See also** [data](qscriptvalue.html#data)（）和[QScriptEngine.reportAdditionalMemoryCost](qscriptengine.html#reportAdditionalMemoryCost)（）。 ``` QScriptValue.setProperty (self, QString?name, QScriptValue?value, PropertyFlags?flags?=?QScriptValue.KeepExistingFlags) ``` 設置這個值[QScriptValue](qscriptvalue.html)的屬性與給定的_name_為給定的_value_。如果這[QScriptValue](qscriptvalue.html)不是一個對象，這個函數不執行任何操作。如果這[QScriptValue](qscriptvalue.html)不已經有名稱的屬性_name_，一個新的屬性被創建;給定的_flags_然后指定這個屬性可以通過腳本代碼來訪問。 If _value_是無效的，該屬性被刪除。如果屬性是使用setter函數實現的（即有[PropertySetter](qscriptvalue.html#PropertyFlag-enum)標志設置），調用的setProperty （）對腳本引擎的副作用，因為setter函數將被調用給定的_value_作為參數（可能導致一個未捕獲的腳本異常）。請注意，您不能為指定自定義的getter或setter函數內置屬性，如`length`Array對象或元屬性的屬性[QObject](qobject.html)對象。 **See also** [property](qscriptvalue.html#property)（）。 ``` QScriptValue.setProperty (self, QScriptString?name, QScriptValue?value, PropertyFlags?flags?=?QScriptValue.KeepExistingFlags) ``` 設置這個值[QScriptValue](qscriptvalue.html)的屬性與給定的_name_為給定的_value_。給定_flags_指定此屬性可以通過腳本代碼來訪問。這種超負荷[setProperty](qscriptvalue.html#setProperty)當你需要多次設置相同的屬性，因為可以執行的操作時，速度更快的名字被表示為一個字符串實習（）是非常有用的。此功能被引入Qt的4.4 。 **See also** [QScriptEngine.toStringHandle](qscriptengine.html#toStringHandle)（）。 ``` QScriptValue.setProperty (self, int?arrayIndex, QScriptValue?value, PropertyFlags?flags?=?QScriptValue.KeepExistingFlags) ``` 這是一個重載函數。設置該屬性在給定_arrayIndex_為給定的_value_。此功能與數組對象時提供了方便和性能。如果這[QScriptValue](qscriptvalue.html)是不是一個Array對象，這個函數的行為就像[setProperty](qscriptvalue.html#setProperty)（）被調用的字符串表示形式_arrayIndex_。 ``` QScriptValue.setPrototype (self, QScriptValue?prototype) ``` 如果這[QScriptValue](qscriptvalue.html)是一個對象，設置內部原型（`__proto__`這個對象是物業）_prototype_否則什么都不做。內部原型不應該與公共財產名稱為“原型”混淆;公眾原型通常只設置在充當構造函數。 **See also** [prototype](qscriptvalue.html#prototype)（）和[isObject](qscriptvalue.html#isObject)（）。 ``` QScriptValue.setScriptClass (self, QScriptClass?scriptClass) ``` 設置此腳本對象的自定義腳本類_scriptClass_。這可以用來“推動”（例如通過在腳本中“新”運算符創建一個簡單的腳本對象，或者通過[QScriptEngine.newObject](qscriptengine.html#newObject)（中） C + +）到自定義類型的對象。 If _scriptClass_為0時，該對象將被降級為普通的腳本對象。此功能被引入Qt的4.4 。 **See also** [scriptClass](qscriptvalue.html#scriptClass)（）和[setData](qscriptvalue.html#setData)（）。 ``` bool QScriptValue.strictlyEquals (self, QScriptValue?other) ``` 返回True如果[QScriptValue](qscriptvalue.html)等于_other_使用嚴格的比較（無轉換），否則返回False 。比較如下所述的行為 [ECMA-262](http://www.ecma-international.org/publications/standards/Ecma-262.htm)11.9.6節， “嚴格相等比較算法” 。如果這種類型[QScriptValue](qscriptvalue.html)是的類型不同_other_值，此函數返回False 。如果類型相同，則結果取決于類型，如下面的表中： | Type | Result | | --- | --- | | Undefined | true | | Null | true | | Boolean | true if both values are true, false otherwise | | Number | false if either value is NaN (Not-a-Number); true if values are equal, false otherwise | | String | true if both values are exactly the same sequence of characters, false otherwise | | Object | true if both values refer to the same object, false otherwise | **See also** [equals](qscriptvalue.html#equals)（）。 ``` bool QScriptValue.toBool (self) ``` 返回此布爾值[QScriptValue](qscriptvalue.html)使用中所描述的轉換規則 [ECMA-262](http://www.ecma-international.org/publications/standards/Ecma-262.htm)第9.2節， “ ToBoolean ” 。注意，如果這個[QScriptValue](qscriptvalue.html)是一個對象，調用這個函數對腳本引擎的副作用，因為引擎會調用對象的valueOf（）的函數（也可能[toString](qscriptvalue.html#toString)（）），試圖將對象轉換為原始值（可能導致一個未捕獲的腳本異常）。此功能被引入Qt的4.5 。 **See also** [isBool](qscriptvalue.html#isBool)（）。 ``` bool QScriptValue.toBoolean (self) ``` ``` QDateTime QScriptValue.toDateTime (self) ``` [](qdatetime.html) [返回](qdatetime.html)[QDateTime](qdatetime.html)這個值的表示，在本地時間。如果這[QScriptValue](qscriptvalue.html)是不是一個日期，或者日期的值是NaN （非數字號碼），無效[QDateTime](qdatetime.html)返回。 **See also** [isDate](qscriptvalue.html#isDate)（）。 ``` int QScriptValue.toInt32 (self) ``` 返回此簽名的32位整數值[QScriptValue](qscriptvalue.html)使用中所描述的轉換規則 [ECMA-262](http://www.ecma-international.org/publications/standards/Ecma-262.htm)第9.5節“ ToInt32 ” 。注意，如果這個[QScriptValue](qscriptvalue.html)是一個對象，調用這個函數對腳本引擎的副作用，因為引擎會調用對象的valueOf（）的函數（也可能[toString](qscriptvalue.html#toString)（）），試圖將對象轉換為原始值（可能導致一個未捕獲的腳本異常）。 **See also** [toNumber](qscriptvalue.html#toNumber)（）和[toUInt32](qscriptvalue.html#toUInt32)（）。 ``` float QScriptValue.toInteger (self) ``` 返回此整數值[QScriptValue](qscriptvalue.html)使用中所描述的轉換規則 [ECMA-262](http://www.ecma-international.org/publications/standards/Ecma-262.htm)9.4節， “ ToInteger ” 。注意，如果這個[QScriptValue](qscriptvalue.html)是一個對象，調用這個函數對腳本引擎的副作用，因為引擎會調用對象的valueOf（）的函數（也可能[toString](qscriptvalue.html#toString)（）），試圖將對象轉換為原始值（可能導致一個未捕獲的腳本異常）。 **See also** [toNumber](qscriptvalue.html#toNumber)（）。 ``` float QScriptValue.toNumber (self) ``` 返回此數值[QScriptValue](qscriptvalue.html)，如在定義 [ECMA-262](http://www.ecma-international.org/publications/standards/Ecma-262.htm)第9.3節， “ ToNumber ” 。注意，如果這個[QScriptValue](qscriptvalue.html)是一個對象，調用這個函數對腳本引擎的副作用，因為引擎會調用對象的valueOf（）的函數（也可能[toString](qscriptvalue.html#toString)（）），試圖將對象轉換為原始值（可能導致一個未捕獲的腳本異常）。 **See also** [isNumber](qscriptvalue.html#isNumber)（）[toInteger](qscriptvalue.html#toInteger)（）[toInt32](qscriptvalue.html#toInt32)（）[toUInt32](qscriptvalue.html#toUInt32)（）和[toUInt16](qscriptvalue.html#toUInt16)（）。 ``` QScriptValue QScriptValue.toObject (self) ``` [](qscriptvalue.html) ``` QMetaObject QScriptValue.toQMetaObject (self) ``` [](qmetaobject.html) [如果這](qmetaobject.html)[QScriptValue](qscriptvalue.html)是[QMetaObject](qmetaobject.html)，返回[QMetaObject](qmetaobject.html)指針的[QScriptValue](qscriptvalue.html)代表，否則返回0 。 **See also** [isQMetaObject](qscriptvalue.html#isQMetaObject)（）。 ``` QObject QScriptValue.toQObject (self) ``` [](qobject.html) [如果這](qobject.html)[QScriptValue](qscriptvalue.html)是[QObject](qobject.html)，返回[QObject](qobject.html)指針的[QScriptValue](qscriptvalue.html)代表，否則返回0 。如果[QObject](qobject.html)這[QScriptValue](qscriptvalue.html)包裹已被刪除，這個函數返回0 （即它有可能為toQObject （）為0 ，即使返回[isQObject](qscriptvalue.html#isQObject)（）返回True ）。 **See also** [isQObject](qscriptvalue.html#isQObject)（）。 ``` QRegExp QScriptValue.toRegExp (self) ``` [](qregexp.html) [返回](qregexp.html)[QRegExp](qregexp.html)這個值表示。如果這[QScriptValue](qscriptvalue.html)是不是正則表達式，空[QRegExp](qregexp.html)返回。 **See also** [isRegExp](qscriptvalue.html#isRegExp)（）。 ``` QString QScriptValue.toString (self) ``` 返回此字符串值[QScriptValue](qscriptvalue.html)，如在定義 [ECMA-262](http://www.ecma-international.org/publications/standards/Ecma-262.htm)第9.8節“的ToString ” 。注意，如果這個[QScriptValue](qscriptvalue.html)是一個對象，調用這個函數對腳本引擎的副作用，因為引擎會調用對象的toString （）函數（以及可能的valueOf （）），試圖將對象轉換為原始值（可能導致一個未捕獲腳本異常）。 **See also** [isString](qscriptvalue.html#isString)（）。 ``` int QScriptValue.toUInt16 (self) ``` 返回此的無符號16位整型值[QScriptValue](qscriptvalue.html)使用中所描述的轉換規則 [ECMA-262](http://www.ecma-international.org/publications/standards/Ecma-262.htm)9.7節， “ ToUint16 ” 。注意，如果這個[QScriptValue](qscriptvalue.html)是一個對象，調用這個函數對腳本引擎的副作用，因為引擎會調用對象的valueOf（）的函數（也可能[toString](qscriptvalue.html#toString)（）），試圖將對象轉換為原始值（可能導致一個未捕獲的腳本異常）。 **See also** [toNumber](qscriptvalue.html#toNumber)（）。 ``` int QScriptValue.toUInt32 (self) ``` 返回此的無符號32位整型值[QScriptValue](qscriptvalue.html)使用中所描述的轉換規則 [ECMA-262](http://www.ecma-international.org/publications/standards/Ecma-262.htm)第9.6節“ ToUint32 ” 。注意，如果這個[QScriptValue](qscriptvalue.html)是一個對象，調用這個函數對腳本引擎的副作用，因為引擎會調用對象的valueOf（）的函數（也可能[toString](qscriptvalue.html#toString)（）），試圖將對象轉換為原始值（可能導致一個未捕獲的腳本異常）。 **See also** [toNumber](qscriptvalue.html#toNumber)（）和[toInt32](qscriptvalue.html#toInt32)（）。 ``` QVariant QScriptValue.toVariant (self) ``` 返回[QVariant](qvariant.html)這個值[QScriptValue](qscriptvalue.html)，如果它可以被轉換成一個[QVariant](qvariant.html)否則返回一個無效的[QVariant](qvariant.html)。該轉換是根據下面的表執行： | Input Type | Result | | --- | --- | | Undefined | An invalid [QVariant](qvariant.html). | | Null | An invalid [QVariant](qvariant.html). | | Boolean | A [QVariant](qvariant.html) containing the value of the boolean. | | Number | A [QVariant](qvariant.html) containing the value of the number. | | String | A [QVariant](qvariant.html) containing the value of the string. | | [QVariant](qvariant.html) Object | The result is the [QVariant](qvariant.html) value of the object (no conversion). | | [QObject](qobject.html) Object | A [QVariant](qvariant.html) containing a pointer to the [QObject](qobject.html). | | Date Object | A [QVariant](qvariant.html) containing the date value ([toDateTime](qscriptvalue.html#toDateTime)()). | | RegExp Object | A [QVariant](qvariant.html) containing the regular expression value ([toRegExp](qscriptvalue.html#toRegExp)()). | | Array Object | The array is converted to a [QVariantList](qvariant.html#QVariantList-typedef). Each element is converted to a [QVariant](qvariant.html), recursively; cyclic references are not followed. | | Object | The object is converted to a [QVariantMap](qvariant.html#QVariantMap-typedef). Each property is converted to a [QVariant](qvariant.html), recursively; cyclic references are not followed. | **See also** [isVariant](qscriptvalue.html#isVariant)（）。