功能属性
重要
建议使用 Microsoft 的 IPP 收件箱类驱动程序以及打印支持应用 (PSA) 来自定义 Windows 10 和 11 中的打印体验,以便进行打印机设备开发。
有关详细信息,请参阅打印支持应用设计指南。
指定打印机功能时,可以使用属性向 Unidrv 提供以下信息:
一个表示功能显示名称的文本字符串。
与该功能关联的打印机选项集。
一个布尔值,该值指示功能是始终存在还是可安装。
如果自定义了该功能,则特征类型和优先级,指示显示该功能的属性表及其相对优先级。
下表列出了按字母顺序排列的功能属性并描述其参数。
属性名 | 属性参数 | 评论 |
---|---|---|
*ConcealFromUI? | TRUE 或 FALSE,指示是否应在用户界面中显示该功能。 | 可选。 如果未指定默认值为 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 根级仅级别属性指定的帮助文件中的索引的数值。 | (也是选项 属性。) |
*可安装? | TRUE 或 FALSE,指示该功能是否可安装。 (FALSE 表示始终安装。 有关详细信息,请参阅“处理可安装功能和选项。 |
可选。 如果未指定,则默认值为 FALSE。 如果 为 TRUE,则除第一个指定的选项外,所有功能选项也是可安装的。 如果 为 FALSE,则至少必须始终安装该功能的选项之一。 (也是选项 属性。) |
*InstallableFeatureName | 显示以询问用户是否实际安装了可安装功能的文本字符串。 有关详细信息,请参阅 “处理可安装功能和选项”。 |
如果 *Installable? 为 TRUE ,且 未指定 *rcInstallableFeatureNameID ,则是必需的。 (也是选项 属性。) |
*名字 | 用作打印机属性表上功能显示名称的文本字符串。 | 可选。 如果未指定, 则必须指定 *rcNameID 。 (也是选项 属性。) |
*选择 | 选项参数,如选项条目格式中所述。 | 必需。 对与该功能关联的每个选项使用 *Option 条目。 |
*rcIconID | 与该功能关联的图标资源的资源 ID。 | 可选。 如果未指定,Unidrv 不会在打印机属性表中显示该功能的图标。 (也是选项 属性。) |
*rcInstallableFeatureNameID | 显示的文本字符串的资源 ID,询问用户是否实际安装了可安装功能。 有关详细信息,请参阅 “处理可安装功能和选项”。 |
如果 *Installable? 为 TRUE ,且 未指定 *InstallableFeatureName ,则是必需的。 (也是选项 属性。) |
*rcNameID | 表示功能名称的字符串资源的资源 ID。 (零不是有效的资源 ID。) | 可选。 如果未指定, 则必须指定 *Name 。 (也是选项 属性。) |
*UpdateQualityMacro? | TRUE 或 FALSE,指示该功能是否包含在指定质量设置的条件语句中(请参阅 控制图像质量)。 | 可选。 如果未指定,则默认值为 FALSE。 (值被迫 如果该功能包含在指定质量设置的条件语句中,则为 TRUE 。 |