FREGetArrayElementAt()

用法

FREResult FREGetArrayElementAt ( 
            FREObject             arrayOrVector, 
            uint32_t             index, 
            FREObject*             value 
);

参数

arrayOrVector

FREObject，表示一个 ActionScript Array 或 Vector 类对象。

index

uint32_t，包含要获取的 Array 或 Vector 元素的索引。Array 或 Vector 对象的第一个元素的索引为 0。

value

指向 FREObject 的指针。此方法会设置此参数所指向的 FREObject 变量。该方法将 FREObject 变量设置为对应于位于所请求索引处的 Array 或 Vector 元素。

返回

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

FRE_OK

函数已成功。 value 参数被设置为所请求的 Array 或 Vector 元素。

FRE_ILLEGAL_STATE

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

FRE_INVALID_ARGUMENT

arrayOrVector 参数对应于一个 ActionScript Vector 对象，但 index 大于最后一个元素的索引。如果 value 参数为 NULL ，也会返回此值。

FRE_INVALID_OBJECT

arrayOrVector FREObject 参数无效。

FRE_TYPE_MISMATCH

arrayOrVector FREObject 参数不表示 ActionScript Array 或 Vector 类对象。

FRE_WRONG_THREAD

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

说明

调用此函数可获取位于 ActionScript Array 或 Vector 类对象的指定索引处的 ActionScript 类对象或基元值。FREObject 参数 arrayOrVector 表示 Array 或 Vector 对象。运行时会设置 value 参数所指向的 FREObject 变量。它将 FREObject 变量设置为对应于相应的 Array 或 Vector 元素。

如果某个 ActionScript Array 对象在请求的索引位置没有值，运行时会将 FREObject value 参数设置为无效，但返回 FRE_OK 。