FREInvalidateBitmapDataRect()

用法

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

参数

object

FREObject，表示先前获取的 ActionScript BitmapData 类对象。

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 对象矩形失效表示运行时将需要重绘矩形。