Cadeias de texto

Importante

A moderna plataforma de impressão é o meio preferido do Windows para comunicar com as impressoras. Recomendamos que utilize o controlador de classe da caixa de entrada IPP da Microsoft, juntamente com as Aplicações de Suporte de Impressão (PSA), 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 o guia de design do aplicativo de suporte Print.

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

• Eles podem ser colocados em um arquivo de recurso. As sequências de texto que exigem localização, como o texto da interface do utilizador, devem ser colocadas num ficheiro de recursos, como descrito em Usando DLLs de Recursos num 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 são normalmente incluídas em arquivos GPD, porque essas cadeias de caracteres não precisam ser localizadas.

As cadeias de caracteres 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 colchete angular esquerdo (", <) 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 de impressora , você deve precedê-lo com outro sinal de porcentagem. Para especificar um comando de impressora que termine com um sinal de porcentagem, especifique dois valores de % hexadecimais, como em

  "command-string<25 25>"

Um exemplo de cadeia de caracteres é o comando que seleciona papel do tamanho de uma carta para a impressora Canon BJC-600. Este 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 uma continuação de linha caractere (+) e delimite o texto em cada linha com aspas.

• Um valor de cadeia de caracteres pode consistir em várias cadeias 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 referentes a cadeias de caracteres definidas em arquivos de recursos, 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 da impressora, consulte Command String Format.