阻止宏

重要

建议使用 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
}