210. JHDrawBitmapIst (立即显示图片指令)
JHZRESULT JHZAPI JHDrawBitmapIst(
HANDLE hdl,
unsigned short index,
short x,
short y,
unsigned short width,
unsigned short height,
unsigned long format,
const JHBMPSRC * pbmpsrc) ;
参数:
hdl [IN] 实例句柄，与控制卡相对应。
index [IN] 指令在批处理文件中基于1开始的索引。
x [IN] 图片显示位置左上角的 X 坐标。
y [IN] 图片显示位置左上角的 Y 坐标。
width [IN] 图片显示区域宽度。
height [IN] 图片显示区域高度。
Format [IN] 图片显示格式, 如下所示：
位 31-8:保留,为 0；
位 7- 6：水平对齐 HALIGN
00：左对齐；
01：水平居中对齐；
10：右对齐；
位 5- 4：
00：上对齐；
01：垂直居中对齐；
10：下对齐；
位 3-0：保留， 为 0；
pbmpsrc [IN] 指向存储图片源信息的内存空间， 图片源信息结构体 BMPSRC 如下：
struct tagBitmapSource{
unsigned short type；
unsigned short version；
unsigned long size；
unsigned char* pdata；
}JHBMPSRC；
type：图片类型， 始终为 0,表示为文件图片；
version: 版本，当前版本为 0；
size: 图片源数据大小；
pdata: 图片源数据； data 为动态数组，大小由 size 决定；
返回值：
JR_OK 成功
JR_INVALID_PARAMETER 参数错误
JR_INVALID_OBJECT 无效的对象
IR_NOT_ENOUGH_CORE 内存不足
功能描述：
在批处理文件中索引为index的位置上添加立即显示图片指令。显示的图片数据为 pbmpsrc.pdat指向的内容，若为文件图片则表示显示图片ID为pbmpsrc.pdata的图片。 显示的区域为x,y,width,height确定的矩形内。