阅读( 225 ) 我要纠错

78.JHDrawText(立即显示文本)

 

JHZRESULT JHZAPI JHDrawText(

 

            HANDLE hdl,

            short x,

            short y,

            unsigned short width,

            unsigned short height,

            unsigned long format,

            const char * pformatstring) ;

 

参数:

hdl   [IN] 实例句柄,与控制卡相对应。

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:水平对齐 HALIGN

00;左对齐;

01:水平居中对齐;

10:右对齐;

位 5- 4:垂直对应方式

00:上对齐;

01:垂直居中对齐;

10:下对齐;

3:保留,始终为 0;

2:wordbreak,自动换行,  0,不自动换行,  1,自动换 行;

 1:单行文本; 0 表示多行文本, 1 表示单行文本;

0:高级文本,0 表示普通文本, 1 表示高级文本;保留,  终为 0;


pformatstring   [IN] 指向存储待显示的文本字符串的内存空间(1-128 字节)。文本字符编码,可包含有效的 ASCII 码(不能包含0x00)和GB2312码,可混用。换行符为 ’\n ’,即 0x0A;水平制表符 ’\t ’,即 0x09,显示4ASCII空格符。


(注: FORMAT 属性说明, 主要注意两类, 单行文本和多行文本

1、单行文本时:

忽略 wordbreak 自动换行设置, 无论是自动换行或是手动在命令中添加换行符 ’\n ’,均忽略,不作换行处理,

2、 多行文本时:

根据设置不作限制, 自动换行和手动换行可同时支持;

 

但是若文本显示所需区域超过当前限制区域, 建议做如下处理:

1、 若为单行文本, 建议不要设置水平居中; 其他可任意搭配;

2、 若为多行文本, 若使用了自动换行, 建议不要使用垂直居中对齐; 若无自动换行, 建议 不要使用任何居中对齐方式;

使用时若遇到上面情况, 可参照上面说明使用,否则为了整体显示效果,系统会自行裁剪部

 


分数据;

返回值:

JR_OK             成功 

JR_INVALID_PARAMETER   参数错误  

JR_INVALID_OBJECT     无效的对象 


功能描述:

   在实例句柄对应控制卡上在x,y, width, height确定的矩形区域内按照format参数 确定的格式显示文本,文本内容由pformatstring指定。


×