FREGetArrayElementAt()

AIR 3.0 以降

使用方法

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

パラメーター

arrayOrVector
ActionScript Array または Vector クラスオブジェクトを表す FREObject。

index
取得するための Array または Vector エレメントのインデックスを含む uint32_t。Array または Vector オブジェクトの最初のエレメントでは、index は 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
FREObject arrayOrVector パラメーターが無効です。

FRE_TYPE_MISMATCH
FREObject arrayOrVector パラメーターは、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 を返します。