鼎恩光彩

3.5 立即显示文本

根据给定文本编码，显示文本，文本字体和大小以及颜色按照系统配置中当前配置值决定。

请求：

CMD：请求命令，0x0238；

X：文本显示位置的X坐标。

Y：文本显示位置的Y坐标。

WIDTH：文本显示区域宽度；

HEIGHT：文本显示区域高度；

FORMAT：文本显示格式；仅在RES为0时存在；

位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；

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

1、单行文本时：

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

2、 多行文本时：

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

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

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

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

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

CNT：TEXT文本编码所占字节数；

TEXT：文本编码，可包含有效的ASCII(不能包含0x00)码和GB2312编码，可混用。只有文本编码；换行符为’\n’，即0x0A；水平制表符’\t’，即0x09，显示为4个ASCII空格符；

回应：

CMD：回应命令，0x8238；

RES：操作结果，0表示成功，其他表示错误，可查看附件1中错误代码。

例：

请求命令：(坐标：PX=0x0000，PY=0x0001；汉字: 啊(0xB0A1),齄(0xF7FE))

AA A5 1A 00 FF FF 00 00 B0 A1 38 02 00 00 00 00 20 00 10 00 00 00 00 00 04 00 B0 A1 F7 FE 00 00 5A 55

回应命令：

AA A5 0A 08 00 00 01 01 B0 A1 38 82 00 00 C5 F9 5A 55