Cadenas de texto

Importante

La plataforma de impresión moderna es el medio preferido de Windows para comunicarse con impresoras. Se recomienda usar el controlador de clase de bandeja de entrada IPP de Microsoft, junto con aplicaciones de soporte técnico de impresión (PSA), para personalizar la experiencia de impresión en Windows 10 y 11 para el desarrollo de dispositivos de impresora.

Para obtener más información, consulte Plataforma de impresión moderna y la Guía de diseño de aplicaciones para compatibilidad con impresión.

Las cadenas de texto son cadenas de caracteres literales, delimitadas por comillas. Las cadenas usadas por los minicontroladores Unidrv pueden colocarse en dos ubicaciones:

• Pueden colocarse en un archivo de recursos. Las cadenas que requieren localización, como el texto de la interfaz de usuario, deben colocarse en un archivo de recursos, como se describe en Uso de DLL de recursos en un minicontrolador.

• Pueden incluirse en archivos GPD. Las cadenas que representan las secuencias de escape que componen los comandos de la impresora suelen incluirse en los archivos GPD, ya que no es necesario localizarlas.

Las cadenas deben obedecer las siguientes reglas:

• Las cadenas deben estar delimitadas por comillas ("...").

• Los valores hexadecimales de bytes pueden colocarse en una cadena delimitando los dígitos hexadecimales mediante corchetes angulares (<...>), como <03> o <1B>. Dentro de un conjunto de corchetes angulares, cada par de dígitos se interpreta como otro valor de byte hexadecimal. Por lo tanto, <03><1B>, <03 1B> y <031B> son equivalentes.

• El signo de porcentaje (%) se usa como carácter de escape. Para incluir una comilla o un corchete angular izquierdo (", <) en una cadena, debe ir precedido de un signo de porcentaje. Para especificar una cadena que termine con un signo de porcentaje, debe especificar el valor hexadecimal de %, como en "<25>".

  Además, para incluir un signo de porcentaje en una cadena de texto que representa un comando de impresora, debe precederlo de otro signo de porcentaje. Para especificar un comando de impresora que termine con un signo de porcentaje, debe especificar dos valores hexadecimales %, como en

  "command-string<25 25>"

Un ejemplo de cadena es el comando que selecciona el papel tamaño carta para la impresora Canon BJC-600. Este comando, que es la secuencia de bytes 1B 28 67 03 00 6E 01 72, se puede especificar como:

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

Cada carácter ASCII incluido en la cadena se convierte a su equivalente hexadecimal de un byte.

• Las cadenas que se incluyen en archivos GPD deben obedecer la siguiente regla adicional:

  Para extender una cadena más allá de una sola línea, preceda cada línea después de la primera con un carácter de continuación de línea (+), y delimite el texto de cada línea con comillas.

• Un valor de cadena puede estar formado por varias cadenas de texto. Por ejemplo, las dos entradas GPD siguientes son equivalentes:

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

Para obtener más información sobre las reglas relativas a las cadenas definidas en los archivos de recursos, consulte la descripción de la sentencia STRINGTABLE en la documentación del SDK de Microsoft Windows.

Para obtener más información sobre la especificación de secuencias de escape de comandos de impresora, consulte Formato de cadenas de comandos.