FRESetArrayLength()

AIR 3.0 和更高版本

用法

FREResult FRESetArrayLength ( 
            FREObject             arrayOrVector, 
            uint32_t             length 
);

参数

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

length
uint32_t,此方法将 Array 或 Vector 类对象的长度设置为此参数的值。

返回

FREResult,可能的返回值包括(但不限于)下列值:

FRE_OK
函数已成功。运行时已更改了 Array 或 Vector 对象的大小。

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

FRE_INSUFFICIENT_MEMORY
运行时无法分配足够的内存以更改 Array 或 Vector 对象的大小。

FRE_INVALID_ARGUMENT
length 参数大于 2 32

FRE_INVALID_OBJECT
arrayOrVector FREObject 参数无效。

FRE_READ_ONLY
arrayOrVector FREObject 参数表示具有固定大小的 ActionScript Vector 对象。(其 fixed 属性为 true。)

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

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

说明

调用此函数可设置 ActionScript Array 或 Vector 类对象的长度。FREObject 参数 arrayOrVector 对应于 Array 或 Vector 对象。运行时根据 length 参数指定的值更改 Array 或 Vector 对象的大小。