144. JHDrawTextIst(立即显示文本指令)
JHZRESULT JHZAPI JHDrawTextIst(
HANDLE phdl,
unsigned short index,
short x,
short y,
unsigned short width,
unsigned short height,
unsigned long format,
const char * pformatstring)
参数:
phdl [IN] 实例句柄,与控制卡对应。
index [IN] 指令在批处理文件中基于1开始的索引。
x [IN] 文本显示位置左上角的 X 坐标。
y [IN] 文本显示位置左上角的 Y 坐标。
width [IN] 文本显示区域宽度,为 0x0000 时为自适应。
height [IN] 文本显示区域高度,为 0x0000 时为自适应。
format [IN] 文本显示格式。
位 31-20:保留,始终为 0。
位 19- 16:颜色(注: 0000 表示使用系统当前颜色;1000 为黑 色)
位 18:蓝色。
位 17:绿色。
位 16:红色。
位 15- 8:字体 ID;有效值为 0-254;为 0 时使用当前字体 ID。
位 7- 6:水平对齐 HALIG
00;左对齐。
01:水平居中对齐。
10:右对齐。
位 5- 4:垂直对齐方式
00:上对齐。
01:垂直居中对齐。
10:下对齐。
位 3:保留,始终为 0。
位 2:wordbreak,自动换行, 为 0,不自动换行, 为 1,自动换 行;
位 1:单行文本; 0 表示多行文本, 1 表示单行文本。
位 0:高级文本,0 表示普通文本, 1 表示高级文本;保留, 始 终为 0。
pformatstring [IN] 指向存储待显示的文本字符串的内存空间。文本字符编码,可 包含有效的 ASCII 码(不能包含 0x00)和 GB2312 编码,可混用。换行 符为 ’\n ’,即 0x0A;水平制表符 ’\t ’,即 0x09,显示为 4 个 ASCII 空格符。
返回值:
JR_OK 成功
JR_INVALID_PARAMETER 参数错误
IR_INVALID_OBJECT 无效的对象
IR_NOT_ENOUGH_CORE 内存不足
功能描述:
在批处理文件中索引为index的位置上添加显示文本指令。显示的文本内容为 pformatstring指向的字符串,显示的区域为x,y,width,height确定的矩形内。