功能属性

重要

新式打印平台是 Windows 与打印机通信的首选方式。 建议使用 Microsoft 的 IPP 收件箱类驱动程序以及打印支持应用 (PSA) 来自定义 Windows 10 和 11 中的打印体验,以便进行打印机设备开发。

有关详细信息,请参阅新式打印平台打印支持应用设计指南

在指定打印机功能时,可以使用属性为 Unidrv 提供以下信息:

  • 一个表示功能显示名称的文本字符串。

  • 与功能相关的打印机选项集。

  • 一个布尔值,表示该功能是始终存在还是可安装。

  • 功能类型和优先级,如果自定义了功能,则表示功能显示在哪个属性表上及其相对优先级。

下表列出了按字母顺序排列的功能属性,并对其参数进行了介绍。

属性名 属性参数 注释
*ConcealFromUI? TRUEFALSE,表示是否应在用户界面中显示该功能。 可选。 如果未指定,则默认值为 FALSE,即表示显示该功能。

只有当某个功能只有一个选项(例如一种分辨率),因此用户无法修改,或者该功能的选项选择是通过设置另一功能的选项来控制时,才应为 TRUE

如果 *ConcealFromUI 属性被设置为 TRUE,则 Unidrv 或 PrintConfig 将在 PrintCapabilities XML 中为该项目的功能元素添加 psk:DisplayUI 元素。
*ConflictPriority 表示特征优先级的数值,其中 1 表示最高优先级。 可选。 请参阅功能冲突优先级
*DefaultOption 一个功能选项的名称。 可选。 如果未指定,则 *Feature 条目中列出的第一个选项就是默认值。 对于 PaperSize 功能,Unidrv 的默认选项在使用公制的地区为 A4,在其他地区为 Letter。 如果默认 PaperSize 不存在,Unidrv 将使用 *DefaultOption 关键字所指定的 PaperSize 选项。
*FeatureType DOC_PROPERTY

JOB_PROPERTY

PRINTER_PROPERTY

如果是 DOC_PROPERTY 或 JOB_PROPERTY,则将该功能分配给文档属性表。 如果是 PRINTER_PROPERTY,则将该功能分配给打印机属性表。
对于自定义功能是必需的。 对于标准功能为可选。 如果未指定,除非另有说明,否则标准功能的默认值为 DOC_PROPERTY。

如果 PRINTER_PROPERTY,则该功能的选项值将保存在注册表中。 如果是 DOC_PROPERTY 或 JOB_PROPERTY,则该功能的选项值将与文档一起保存。
*HelpIndex 表示由 *HelpFile root-level-only 属性指定的帮助文件中的索引的数值。 (也是一个选项属性。)
*Installable? TRUEFALSE,指明该功能是否可安装。 (FALSE 表示始终安装。)

有关详细信息,请参阅处理可安装的功能和选项
可选。 如果未指定,默认值为 FALSE。 如果为 TRUE,则除指定的第一个选项外,所有功能选项也都可以安装。 如果为 FALSE,则必须始终安装该功能的至少一个选项。 (也是一个选项属性。)
*InstallableFeatureName 显示的文本字符串,用于询问用户是否实际安装了可安装功能。

有关详细信息,请参阅处理可安装的功能和选项
如果 *Installable?TRUE,且未指定 *rcInstallableFeatureNameID,则为必需。 (也是一个选项属性。)
*Name 用作打印机属性表上功能显示名称的文本字符串。 可选。 如果未指定,则必须指定 *rcNameID。 (也是一个选项属性。)
*Option 选项参数,如选项条目格式中所述。 必需。 对与功能相关的每个选项使用 *Option 条目。
*rcIconID 与功能关联的图标资源的资源 ID。 可选。 如果未指定,则 Unidrv 不会在打印机属性表中显示功能的图标。 (也是一个选项属性。)
*rcInstallableFeatureNameID 显示的文本字符串的资源 ID,询问用户是否实际安装了可安装功能。

有关详细信息,请参阅处理可安装的功能和选项
如果 *Installable?TRUE,且未指定 *InstallableFeatureName,则为必需。 (也是一个选项属性。)
*rcNameID 表示功能名称的字符串资源的资源 ID。 (零不是有效的资源 ID。) 可选。 如果未指定,则必须指定 *Name。 (也是一个选项属性。)
*UpdateQualityMacro? TRUEFALSE,表示该功能是否包含在指定质量设置的条件语句中(请参阅控制图像质量)。 可选。 如果未指定,默认值为 FALSE。 (如果功能包含在指定质量设置的条件语句中,则该值将强制为 TRUE。)