命令字符串参数类型
重要
新式打印平台是 Windows 与打印机通信的首选方式。 建议使用 Microsoft 的 IPP 收件箱类驱动程序以及打印支持应用 (PSA) 来自定义 Windows 10 和 11 中的打印体验,以便进行打印机设备开发。
有关详细信息,请参阅新式打印平台和打印支持应用设计指南。
在命令字符串中包含参数时,必须指定每个参数的类型。 每个参数类型规范都是一个字母,前面有一个百分号。
下表列出了所有的参数类型说明符:
参数类型说明符 | 结果值的说明 |
---|---|
%<Digits>d | 表示十进制数值的 ASCII 字符串,如果是负数,则包括减号。 <Digits> 是一个可选数字,表示字符串长度。 |
%<Digits>D | 表示十进制数值的 ASCII 字符串,包括加减符号。 <Digits> 是一个可选数字,表示字符串长度。 |
%c | 二进制字节。 |
%C | 添加到 ASCII "0" 的二进制字节。 |
%f | 表示十进制值的无符号 ASCII 字符串,小数点插入右起第三个字符,如“12.25”。 |
%g | 2 * ABS(Parameter) + IS_NEGATIVE(Parameter) 作为基 64 数,从最低有效数字到最高有效数字。 最高有效数字 (0-63) 由 191 至 254 字节表示。 所有其他数字由 63 至 126 字节表示。 如果 Parameter 为负值,则“IS_NEGATIVE(Parameter)” 为 1,否则为 0。 |
%l | 二进制字,最低有效字节在前。 |
%m | 二进制字,最高有效字节在前。 |
%n | Canon 整数编码。 从最高有效字节到最低有效字节的二进制编码值。 4 个最低有效位编码为 001sbbbb,其中 s 表示符号(0 为负,1 为正),而 b 表示整数的一个有效位。 接下来最高有效的 6 位编码为 01bbbbbb。 例如,254 (11111110) 表示为 (01001111 00111110)。 |
%q | 表示 QUME 十六进制数的 ASCII 字符串。 用于 Toshiba/Qume 设备。 |
%v | NEC VFU(垂直格式单元)编码。 指定变量的值除以 1/6 英寸。 结果就是向打印机发送 VFU 数据的次数。 |
可以为任何参数指定一个可接受值的范围。 为此,请将参数的最小值和最大值置于一组方括号([, ])中,紧跟参数类型说明符之后,并用逗号分隔。 例如,以下命令会将 0 到 255 指定为 LinefeedSpacing/2 值的可接受范围:
*Command:CmdSetLineSpacing{*Cmd:"<1B>3"%c[0,255]{(LinefeedSpacing/2)}}