文本字符串

重要

建议使用 Microsoft 的 IPP 收件箱类驱动程序,以及 Print Support Apps (PSA) ,在 Windows 10 和 11 中自定义打印体验,以便进行打印机设备开发。

有关详细信息,请参阅 打印支持应用设计指南

文本字符串是文本字符的字符串,由引号分隔。 Unidrv 微型驱动程序使用的字符串可以放置在以下两个位置之一:

  • 它们可以放置在资源文件中。 需要本地化的字符串(如用户界面文本)应放置在资源文件中,如 在微型驱动程序中使用资源 DLL 中所述。

  • 它们可以包含在 GPD 文件中。 表示构成打印机命令的转义序列的字符串通常包含在 GPD 文件中,因为这些字符串不需要本地化。

字符串必须遵循以下规则:

  • 字符串必须用引号 (“...”) 分隔。

  • 十六进制字节值可以通过尖括号分隔十六进制数字 (<...>) (如 <03> 或 <1B>)来放置在字符串中。 在一组尖括号内,每对数字被解释为另一个十六进制字节值。 因此 <,03><1B>、 <03 1B> 和 <031B> 都是等效的。

  • 百分号 (%) 用作转义字符。 若要包含引号或左尖括号 (“, <) 字符串中,请在其前面加上百分号。 若要指定以百分号结尾的字符串,必须指定 %的十六进制值,如“<25>”。

    此外,若要在表示 打印机命令的文本字符串中包含百分号,必须在它前面加上另一个百分号。 若要指定以百分号结尾的打印机命令,必须指定两个十六进制百分比值,如

    “command-string<25 25>”

示例字符串是用于为佳能 BJC-600 打印机选择字母大小的纸张的命令。 此命令是字节序列 1B 28 67 03 00 6E 01 72,可指定为:

“<1B> (g<03 00>n<01>r”

字符串中包含的每个 ASCII 字符将转换为其等效的一字节十六进制字符。

  • GPD 文件中包含的字符串必须遵循以下附加规则:

    若要将字符串扩展到单行之外,请在第一行后的每一行前面加上行 继续 符 (+) ,并使用引号分隔每行上的文本。

  • 一个字符串值可以包含多个文本字符串。 例如,以下两个 GPD 条目等效:

    *Name: "abc""def" *% Comment
    +      "gh"    "ijk"
    
    *Name: "abcdefghijk"
    

有关资源文件中定义的字符串的其他规则,请参阅Microsoft Windows SDK文档中的 STRINGTABLE 语句说明。

有关指定打印机命令转义序列的详细信息,请参阅 命令字符串格式