Ciągi tekstowe

Ważne

Nowoczesna platforma drukowania jest preferowanym sposobem komunikacji z drukarkami w systemie Windows. Zalecamy używanie sterownika klasy skrzynki odbiorczej IPP firmy Microsoft wraz z aplikacjami do obsługi drukowania (PSA), aby dostosować środowisko drukowania w systemie Windows 10 i 11 na potrzeby opracowywania urządzeń drukarki.

Aby uzyskać więcej informacji, zobacz Print Support App v1 and v2 design guide (Przewodnik projektowania aplikacji do obsługi wydruku w wersji 1 i 2).

Ciągi tekstowe to ciągi znaków dosłownych oddzielonych cudzysłowami. Ciągi, które są używane przez minidrivery Unidrv, można umieścić w jednej z dwóch możliwych lokalizacji:

• Można je umieścić w pliku zasobów. Ciągi wymagające lokalizacji, takie jak tekst interfejsu użytkownika, powinny być umieszczane w pliku zasobów, zgodnie z opisem w temacie Używanie bibliotek DLL zasobów w ministerowniku.

• Można je uwzględnić w plikach GPD. Ciągi reprezentujące sekwencje ucieczki tworzące polecenia drukarki są zwykle zawarte w plikach GPD, ponieważ te ciągi nie muszą być zlokalizowane.

Ciągi muszą przestrzegać następujących reguł:

• Ciągi muszą być rozdzielane znakami cudzysłowu ("...").

• Wartości bajtów szesnastkowych można umieścić w ciągu, rozdzielając cyfry szesnastkowe według nawiasów kątowych (<...>), takich jak <03> lub <1B>. W zestawie nawiasów kątowych każda para cyfr jest interpretowana jako inna wartość bajtu szesnastkowego. W związku z tym <03><1B>, <03 1B> i <031B> są równoważne.

• Znak procentu (%) jest używany jako znak ucieczki. Aby dołączyć cudzysłów lub lewy nawias kątowy (", <) w ciągu tekstowym, poprzedź go znakiem %. Aby określić ciąg kończący się znakiem procentowym, należy określić wartość szesnastkowa dla %, jak w ciągu "<25>".

  Ponadto, aby uwzględnić znak procentowy w ciągu tekstowym reprezentującym polecenie drukarki, należy poprzedzić go innym znakiem procentowym. Aby określić polecenie drukarki kończące się znakiem procentowym, należy określić dwie wartości szesnastkowe %, jak w

  command-string<25 25>

Przykładowy ciąg to polecenie, które wybiera papier o rozmiarze litery dla drukarki Canon BJC-600. To polecenie, które jest sekwencją bajtów 1B 28 67 03 00 6E 01 72, można określić jako:

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

Każdy znak ASCII zawarty w ciągu jest konwertowany na jednobajtowy odpowiednik szesnastkowy.

• Ciągi zawarte w plikach GPD muszą przestrzegać następującej dodatkowej reguły:

  Aby rozszerzyć ciąg poza pojedynczy wiersz, poprzedzić każdy wiersz po pierwszym znakiem kontynuacji wiersza (+) i rozdzielić tekst w każdym wierszu znakami cudzysłowu.

• Wartość ciągu może składać się z wielu ciągów tekstowych. Na przykład następujące dwa wpisy GPD są równoważne:

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

Aby uzyskać dodatkowe reguły dotyczące ciągów zdefiniowanych w plikach zasobów, zapoznaj się z opisem instrukcji STRINGTABLE w dokumentacji zestawu Microsoft Windows SDK.

Aby uzyskać więcej informacji na temat określania sekwencji ucieczki poleceń drukarki, zobacz Format ciągu polecenia.