FRENewObject()

使用方法

FREResult FRENewObject( 
            const uint8_t*                className, 
            uint32_t                argc, 
            FREObject                argv[], 
            FREObject*                object, 
            FREObject*                thrownException 
);

パラメーター

className

uint8_t 配列。オブジェクトを作成する ActionScript クラスの名前を示す文字列です。この文字列には UTF-8 エンコーディングを使用し、null 文字で終了します。

argc

uint32_t。ActionScript クラスのコンストラクターに渡すパラメーター数。このパラメーターは、 argv 配列パラメーターの長さを表します。コンストラクターにパラメーターがない場合、この値は 0 となります。

argv[]

FREObject 配列。各 FREObject エレメントは、コンストラクターにパラメーターとして渡された ActionScript クラスまたはプリミティブ型に対応します。コンストラクターにパラメーターがない場合は、この値は NULL となります。

object

FREObject へのポインター。このメソッドが成功した場合、この FREObject 変数は新しい ActionScript クラスオブジェクトを表します。

thrownException

FREObject へのポインター。このメソッドを呼び出すことによりランタイムが ActionScript 例外をスローした場合、この FREObject 変数は、ActionScript Error オブジェクトまたは Error サブクラスのオブジェクトを表します。エラーが発生しない場合、ランタイムはこの FREObject 変数を無効に設定します。つまり、thrownException FREObject 変数に FREGetObjectType() を実行すると、 FRE_INVALID_OBJECT が返されます。例外情報の処理を行わない場合は、このポインターを NULL に設定できます。

戻り値

FREResult。戻り値には、以下が含まれます（ただし、これらに限定されません）。

FRE_OK

関数は成功しました。 object パラメーターは、新しい ActionScript クラスオブジェクトを表します。

FRE_ACTIONSCRIPT_ERROR

ActionScript エラーが発生しました。ランタイムは thrownException パラメーターを、ActionScript Error クラスオブジェクトまたは Error サブクラスオブジェクトを表すように設定します。

FRE_ILLEGAL_STATE

拡張コンテキストは既に ActionScript BitmapData または ByteArray オブジェクトを取得しています。この BitmapData または ByteArray オブジェクトを解放するまでは、コンテキストはこのメソッドを呼び出すことはできません。

FRE_INVALID_ARGUMENT

className または object パラメーターが NULL であるか、 argc が 1 以上かつ argv が NULL または空です。

FRE_NO_SUCH_NAME

className パラメーターは、ActionScript クラス名と一致しません。

FRE_WRONG_THREAD

ランタイムにネイティブ拡張関数に対する未実行の呼び出しがあるスレッドとは別のスレッドから、メソッドが呼び出されました。

説明

ActionScript クラスのオブジェクトを作成するには、この関数を呼び出します。ランタイムが呼び出すコンストラクターは、 argv 配列に渡すパラメーターによって異なります。