Makra wartości

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).

Makro wartości służy do określania zestawu co najmniej jednej wartości, która ma zostać wstawiona indywidualnie i wielokrotnie w pliku ogólnego opisu drukarki (GPD). Wartości mogą być dowolnymi typami wartości GPD.

Następujące reguły mają zastosowanie do użycia makr wartości:

• Definicja makra wartości w pliku GPD musi znajdować się przed wszelkimi odwołaniami do niego.

• Makro wartości zdefiniowane na poziomie nadrzędnym (to znaczy, nie wewnątrz nawiasów klamrowych) staje się dostępne za pośrednictwem pliku GPD, który je definiuje, po jego zdefiniowaniu. W przeciwnym razie zakres makra wartości jest zestawem nawiasów klamrowych po lewej i prawej zawierającej jego definicję.

• Makro wartości musi być dopasowane do jednego z typów wartości GPD.

• Definicja makra wartości może odwoływać się do innych wcześniej zdefiniowanych makr wartości, jeśli wszystkie wartości są ciągami tekstowymi, ale makro wartości nie może się odwoływać do samego siebie.

• Makra wartości nie akceptują argumentów.

• Jeśli utworzysz dwa makra wartości o tej samej nazwie, pierwsza definicja będzie obowiązywać, dopóki analizator GPD nie napotka drugiej definicji. Druga definicja zastępuje pierwszą. Jeśli zakres drugiej definicji zakończy się, pierwsza definicja zostanie przywrócona.

Format makra wartości

Aby zdefiniować co najmniej jedno makro wartości w pliku GPD, użyj następującego formatu:

*Makra: *ValueMacroGroupName { ValueMacroBody }

Gdzie ValueMacroGroupName jest unikatową nazwą, a ValueMacroBody jest zestawem unikatowych nazw wartości i skojarzonych wartości w następujący sposób:

ValueMacroName : MacroValue

Gdzie ValueMacroName jest unikatową nazwą makra, a MacroValue reprezentuje typ wartości GPD. (MacroValue może zawierać odwołania do wcześniej zdefiniowanych makr wartości, o ile rozpoznany ciąg reprezentuje typ wartości GPD).

Na przykład można zdefiniować makra wartości dla zestawu często używanych prefiksów poleceń w następujący sposób:

*Macros: HP4L
{
    LetterCmdPrefix: "<1B>&l2a8c1E<1B>*p0x0Y"
    A4CmdPrefix: "<1B>&l26a8c1E<1B>*p0x0Y"
    Env10CmdPrefix: "<1B>&l81a8c1E<1B>*p0x0Y"
}

ValueMacroGroupName (HP4L w przykładzie) jest opcjonalny i traktowany jako komentarz.

Odwoływanie się do makr danych wartości

Aby odwołać się do makra wartości, użyj następującego formatu:

= ValueMacroName

Gdzie ValueMacroName jest unikatową nazwą, wcześniej określoną w wpisie *Macros definiującym makro.

Aby na przykład odwołać się do jednego z makr HP4L w specyfikacji polecenia, można użyć następujących wpisów:

*Command: CmdSelect
{
    *Cmd: =LetterCmdPrefix "<1B>*c0t5760x7680Y"
}

Jedynym przypadkiem, kiedy można przypisać wartość przez łączenie odwołań do makr z wartościami innymi niż makro, występuje, gdy wszystkie definicje makr i inne wartości są podciągami tekstów lub komend, jak pokazano w przykładzie. We wszystkich innych przypadkach odwołanie do makra musi reprezentować całą wartość, która ma zostać przypisana.