功能属性

重要

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

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

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

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

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

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

  • 如果自定义了该功能,则特征类型和优先级,指示显示该功能的属性表及其相对优先级。

下表列出了按字母顺序排列的功能属性并描述其参数。

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

仅当某个功能只有一个选项(例如,一种分辨率)且不可修改,或者,如果功能的选项选择通过设置其他功能的选项来控制,则为 TRUE

如果 *ConcealFromUI 属性设置为 TRUE,则 Unidrv 或 PrintConfig 会将 psk:DisplayUI 元素添加到 PrintCapabilities XML 中此项的功能元素。
*ConflictPriority 表示特征优先级的数值,其中 1 是最高优先级。 可选。 请参阅 功能冲突优先级
*DefaultOption 功能选项之一的名称。 可选。 如果未指定,*功能条目中列出的第一个选项是默认值。 对于 PaperSize 功能,Unidrv 的默认选项是其他位置的指标区域设置和 Letter 的 A4。 如果默认 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 根级仅级别属性指定的帮助文件中的索引的数值。 (也是选项 属性。)
*可安装? TRUEFALSE,指示该功能是否可安装。 (FALSE 表示始终安装。

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

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

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