Cadeias de caracteres de texto

Importante

A plataforma de impressão moderna é o meio preferencial do Windows para se comunicar com as impressoras. Recomendamos que você use o driver de classe de caixa de entrada IPP da Microsoft juntamente com PSA (Aplicativos de Suporte à Impressão) para personalizar a experiência de impressão no Windows 10 e 11 para o desenvolvimento de dispositivos de impressora.

Para obter mais informações, consulte Plataformade impressão moderna e o Guia de design do aplicativo de suporte de impressão.

Cadeias de caracteres de texto são cadeias de caracteres literais, delimitadas por aspas. As cadeias de caracteres usadas por minidrivers Unidrv podem ser colocadas em um dos dois locais:

• Eles podem ser colocados em um arquivo de recurso. As cadeias de caracteres que exigem localização, como texto da interface do usuário, devem ser colocadas em um arquivo de recurso, conforme descrito em Usando DLLs de recurso em um Minidriver.

• Eles podem ser incluídos em arquivos GPD. As cadeias de caracteres que representam as sequências de escape que compõem os comandos da impressora geralmente são incluídas nos arquivos GPD, pois essas cadeias de caracteres não precisam ser localizadas.

As aspas devem obedecer às seguintes regras:

• As cadeias de caracteres devem ser delimitadas por aspas ("...").

• Os valores de bytes hexadecimais podem ser colocados em uma cadeia de caracteres delimitando dígitos hexadecimais por colchetes angulares (<...>), como <03> ou <1B>. Dentro de um conjunto de colchetes angulares, cada par de dígitos é interpretado como outro valor de byte hexadecimal. Portanto, <03><1B>, <03 1B>, e <031B> são todos equivalentes.

• O sinal de porcentagem (%) é usado como um caractere de escape. Para incluir aspas ou colchetes angulares esquerdos (", <) em uma cadeia de caracteres, preceda-a com um sinal de porcentagem. Para especificar uma cadeia de caracteres que termina com um sinal de porcentagem, você deve especificar o valor hexadecimal para %, como em "<25>".

  Além disso, para incluir um sinal de porcentagem em uma cadeia de caracteres de texto que representa um comando da impressora, você deve precedê-lo por outro sinal de porcentagem. Para especificar um comando de impressora que termina com um sinal de porcentagem, você deve especificar dois valores % hexadecimais, como em

  "command-string<25 25>"

Um exemplo de string é o comando que seleciona papel de tamanho carta para a impressora Canon BJC-600. Esse comando, que é a sequência de bytes 1B 28 67 03 00 6E 01 72, pode ser especificado como:

"<1B>(g<03 00>n<01>r"

Cada caractere ASCII incluído na cadeia de caracteres é convertido em seu equivalente hexadecimal de um byte.

• As cadeias de caracteres incluídas em arquivos GPD devem obedecer à seguinte regra adicional:

  Para estender uma cadeia de caracteres além de uma única linha, preceda cada linha após a primeira com um caractere de continuação de linha (+) e delimite o texto em cada linha com aspas.

• Um valor de cadeia de caracteres pode consistir em várias cadeias de caracteres de texto. Por exemplo, as duas entradas GPD a seguir são equivalentes:

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

Para obter regras adicionais relativas a cadeias de caracteres definidas em arquivos de recurso, consulte a descrição da instrução STRINGTABLE na documentação do SDK do Microsoft Windows.

Para obter mais informações sobre como especificar sequências de escape de comando de impressora, consulte Formato de cadeia de caracteres de comando.