Stringhe di testo

Importante

La piattaforma di stampa moderna è il mezzo preferito di Windows per comunicare con le stampanti. Ti consigliamo di usare il driver di classe IPP di Microsoft, insieme a Print Support Apps (PSA), per personalizzare l'esperienza di stampa in Windows 10 e 11 per lo sviluppo di dispositivi per stampanti.

Per ulteriori informazioni, consultare la guida alla progettazione dell'app di supporto alla stampa .

Le stringhe di testo sono stringhe di caratteri letterali, delimitate da virgolette. Le stringhe usate dai minidriver Unidrv possono essere inserite in una delle due posizioni seguenti:

• Possono essere inseriti in un file di risorse. Le stringhe che richiedono la localizzazione, ad esempio il testo dell'interfaccia utente, devono essere inserite in un file di risorse, come descritto in Uso di DLL di risorse in un minidriver.

• Possono essere inclusi nei file GPD. Le stringhe che rappresentano le sequenze di escape che costituiscono i comandi della stampante vengono in genere incluse nei file GPD, perché queste stringhe non devono essere localizzate.

Le stringhe devono rispettare le regole seguenti:

• Le stringhe devono essere delimitate tra virgolette ("...").

• I valori di byte esadecimali possono essere inseriti in una stringa delimitando cifre esadecimali per parentesi angolari (<...>), ad esempio <03> o <1B>. All'interno di un set di parentesi angolari, ogni coppia di cifre viene interpretata come un altro valore di byte esadecimale. Pertanto <, 03><1B>, <03 1B> e <031B> sono tutti equivalenti.

• Il segno di percentuale (%) viene usato come carattere di escape. Per includere una virgoletta o una parentesi uncinata sinistra (", <) in una stringa, precederla con un segno di percentuale. Per specificare una stringa che termina con un segno di percentuale, è necessario specificare il valore esadecimale per %, come in "<25>".

  Inoltre, per includere un segno di percentuale in una stringa di testo che rappresenta un comando della stampante, è necessario precederlo con un altro segno di percentuale. Per specificare un comando della stampante che termina con un segno di percentuale, è necessario specificare due valori % esadecimali, come in

  "command-string<25 25>"

Una stringa di esempio è il comando che seleziona carta in formato lettera per la stampante Canon BJC-600. Questo comando, ovvero la sequenza di byte 1B 28 67 03 00 6E 01 72, può essere specificata come:

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

Ogni carattere ASCII incluso nella stringa viene convertito nell'equivalente esadecimale a un byte.

• Le stringhe incluse nei file GPD devono rispettare la regola aggiuntiva seguente:

  Per estendere una stringa oltre una singola riga, precedere ogni riga dopo la prima con un carattere di continuazione riga (+) e delimitare il testo in ogni riga con virgolette.

• Un valore stringa può essere costituito da più stringhe di testo. Ad esempio, le due voci GPD seguenti sono equivalenti:

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

Per altre regole relative alle stringhe definite nei file di risorse, vedere la descrizione dell'istruzione STRINGTABLE nella documentazione di Microsoft Windows SDK.

Per altre informazioni sulla specifica delle sequenze di escape dei comandi della stampante, vedere Formato stringa di comando.