FRESetObjectProperty()

用法

FREResult FRESetObjectProperty ( 
                FREObject                 object, 
                const uint8_t*                 propertyName, 
                FREObject                propertyValue, 
                FREObject*                thrownException 
);

参数

object

FREObject，表示要设置属性的 ActionScript 类对象。

propertyName

uint8_t 数组。此数组包含一个表示要设置的属性名称的字符串。字符串使用 UTF-8 编码，并以 null 字符终止。

propertyValue

FREObject，表示要设置的属性值。

thrownException

指向 FREObject 的指针。如果调用此方法会导致运行时引发 ActionScript 异常，则此 FREObject 变量表示 ActionScript Error（或 Error 子类）对象。如果未发生错误，则运行时会将此 FREObject 变量设置为无效。即，thrownException FREObject 变量的 FREGetObjectType() 会返回 FRE_INVALID_OBJECT 。如果您不希望处理异常信息，则此指针可以是 NULL 。

返回

FREResult，可能的返回值包括（但不限于）下列值：

FRE_OK

函数已成功并且正确设置了 ActionScript 类对象的属性。

FRE_ACTIONSCRIPT_ERROR

发生 ActionScript 错误。运行时将 thrownException 参数设置为表示 ActionScript Error 类或子类对象。

FRE_ILLEGAL_STATE

扩展上下文已获取一个 ActionScript BitmapData 对象或 ByteArray 对象。在释放 BitmapData 或 ByteArray 对象之前，上下文无法调用此方法。

FRE_INVALID_ARGUMENT

propertyName 参数为 NULL 。

FRE_INVALID_OBJECT

object 或 propertyValue 参数为无效 FREObject 变量。

FRE_NO_SUCH_NAME

propertyName 参数与 object 参数表示的 ActionScript 类对象的属性不匹配。也存在导致返回此值的另一种原因（不太可能）。尤其是，考虑某个 ActionScript 类具有两个名称相同的属性，但这两个名称位于不同的 ActionScript 命名空间中这一不常见的情况。

FRE_READ_ONLY

要设置的属性为只读属性。

FRE_TYPE_MISMATCH

FREObject object 参数不表示 ActionScript 类对象。

FRE_WRONG_THREAD

从运行时在其中具有对本机扩展函数的未决调用的线程以外的线程调用了方法。

说明

调用此函数可设置 FREObject 变量表示的 ActionScript 类对象的公共属性的值。通过 propertyName 参数传递要设置的属性名称。通过 propertyValue 参数传递新的属性值。