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 クラスオブジェクトまたは 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 クラスに 2 つの同名のプロパティがあるものの、これらが異なる ActionScript 名前空間のものであるという、稀なケースが考えられます。

FRE_READ_ONLY

設定するプロパティは読み取り専用プロパティです。

FRE_TYPE_MISMATCH

FREObject object パラメーターは ActionScript クラスオブジェクトを表していません。

FRE_WRONG_THREAD

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

説明

FREObject 変数が表す ActionScript クラスオブジェクトの public プロパティの値を設定するには、この関数を呼び出します。 propertyName パラメーターに、設定するプロパティの名前を渡します。 propertyValue パラメーターに、新しいプロパティ値を渡します。