FREInvalidateBitmapDataRect()

AIR 3.0 以降

使用方法

FREResult FREInvalidateBitmapDataRect( 
            FREObject object, 
            uint32_t x, 
            uint32_t y, 
            uint32_t width, 
            uint32_t height 
);

パラメーター

object
以前取得した ActionScript BitmapData クラスオブジェクトを表す FREObject。

x
uint32_t。この値は、x 座標をピクセル単位で表します。この値はビットマップの左上隅からの相対位置です。この値は、 y パラメーターと一緒に使用して、無効にする長方形領域の左上隅を示します。

y
uint32_t。この値は、y 座標をピクセル単位で表します。この値はビットマップの左上隅からの相対位置です。この値は、 x パラメーターと一緒に使用して、無効にする長方形領域の左上隅を示します。

width
uint32_t。この値は、無効にする長方形領域のピクセル単位の幅です。

height
uint32_t。この値は、無効にする長方形領域のピクセル単位の高さです。

戻り値

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

FRE_OK
関数は成功しました。指定した長方形領域が無効になりました。

FRE_ILLEGAL_STATE
拡張コンテキストは、ActionScript BitmapData オブジェクトを取得していません。

FRE_INVALID_OBJECT
FREObject object パラメーターは無効です。

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

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

説明

ActionScript BitmapData クラスオブジェクトの長方形領域を無効にするには、この関数を呼び出します。この関数を呼び出す前に、 FREAcquireBitmapData() または FREAcquireBitmapData2() を呼び出します。ビットマップの操作と無効化が完了した後に、 FREReleaseBitmapData() を呼び出します。

BitmapData オブジェクトの長方形領域を無効にすると、ランタイムはその長方形領域を再描画することが必要になります。