共用方式為


文字字串

重要

新式列印平臺是 Windows 與印表機通訊的慣用方法。 我們建議您使用Microsoft的 IPP 收件匣類別驅動程式,以及列印支援應用程式 (PSA),自定義 Windows 10 和 11 中的列印體驗,以進行印表機裝置開發。

如需詳細資訊,請參閱 新式列印平臺列印支援應用程式設計指南

文字字串是常值字元的字串,以引號分隔。 Unidrv minidrivers 所使用的字串可以放在兩個位置的其中一個:

  • 它們可以放在資源檔中。 需要本地化的字串,例如使用者介面文字,應該放在資源檔中,如在Minidriver中使用資源 DLL 中所述

  • 這些檔案可以包含在 GPD 檔案中。 代表組成印表機命令之逸出序列的字串通常會包含在 GPD 檔案中,因為這些字串不需要當地語系化。

字串必須遵守下列規則:

  • 字串必須以引號 (“...”) 分隔。

  • 十六進位位元組值可以藉由以角括弧 (<...>) 分隔十六進位數位,例如 <03> 或 <1B>,以放在字串中。 在一組角括弧內,每個數位組都會解譯為另一個十六進位位位元組值。 因此 <,03><1B>、 <03 1B> 和 <031B> 都相等。

  • 百分比符號 \ 會當做逸出字元使用。 若要在字串中包含引號或左角括弧 (“, ) , <請在其前面加上百分比符號。 若要指定以百分比符號結尾的字串,您必須將 % 的十六進位值指定為 「<25>」。

    此外,若要在代表 印表機命令的文字字串中包含百分比符號,您必須在它前面加上另一個百分比符號。 若要指定以百分比符號結尾的印表機命令,您必須指定兩個十六進位 % 值,如 中所示

    “command-string<25 25>”

範例字串是針對 Canon 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 語句描述。

如需指定印表機命令逸出序列的詳細資訊,請參閱 命令字串格式