區塊巨集

重要

新式列印平臺是 Windows 與印表機通訊的慣用方法。我們建議您使用Microsoft的 IPP 收件匣類別驅動程式，以及列印支援應用程式（PSA），自定義 Windows 10 和 11 中的列印體驗，以進行印表機裝置開發。

區塊巨集用來分隔一組您想要重複插入 GPD 檔案的 GPD 檔案專案。您可以在區塊巨集定義中包含任何項目類型，例如功能與選項語句、屬性規格，以及值巨集或其他區塊巨集的參考。

下列規則適用於使用區塊巨集：

GPD 檔案內的區塊巨集定義必須位於它的任何參考之前。
在根層級定義的區塊巨集（也就是，不是大括弧內）可透過定義該區塊的 GPD 檔案，在定義它之後取得。否則，區塊的範圍巨集是包含其定義的左右大括弧集合。
區塊巨集定義可以包含其他區塊巨集和值巨集的定義。
區塊巨集定義可以參考其他先前定義的區塊巨集和值巨集，但無法參考本身。
區塊巨集不接受自變數。
如果大括弧包含在巨集主體中，則必須配對（也就是說，必須有相等的左右大括弧數目）。
如果您建立兩個具有相同名稱的區塊巨集，則第一個定義會生效，直到 GPD 剖析器遇到第二個定義為止。第二個定義接著會取代第一個定義。如果第二個定義的範圍結束，則會恢復第一個定義。

封鎖巨集格式

若要在 GPD 檔案中定義區塊巨集，請使用下列格式：

*BlockMacro： BlockMacroName {BlockMacroBody}

其中 BlockMacroName 是唯一的名稱，而 BlockMacroBody 是一組一或多個 GPD 檔案專案。如果 BlockMacroBody 包含大括弧，則必須包含左右大括弧（{， } ）的等號。

例如，您可以定義名為 EnvelopeDefaults 的區塊巨集，如下所示：

*BlockMacro: EnvelopeDefaults
{
    *PrintableArea: PAIR(4646, 6738)
    *PrintableOrigin: PAIR(150, 150)
    *RotateSize: TRUE
}

若要參考區塊巨集，請使用下列格式：

*InsertBlock： =BlockMacroName

其中 BlockMacroName 是唯一名稱，先前在定義巨集的 *BlockMacro 專案中指定。

例如，若要參考選項規格內的 EnvelopeDefaults 巨集，您可以使用下列專案：

*Option: Env9
{
    *InsertBlock: =EnvelopeDefaults
}