颜色属性

重要

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

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

颜色属性是一般打印属性，它指定了控制彩色打印的特性。

下表列出了颜色属性。

属性名	属性参数	注释
ChangeColorModeOnDoc?	TRUE 或 FALSE。 表示打印机的颜色模式是否可以在文档页面之间更改而不会产生副作用。	可选。 如果未指定，默认值为 TRUE。 Unidrv 使用该值来优化打印速度。 有关详细信息，请参阅此表后面的文字。
CyanInMagentaDye	从 0 到 1000 的数字值，表示洋红色染料中青色污染的百分比。 该值为污染百分比乘以 100。 例如，8.4% 的污染会被指定为 840，10% 为 1000。	可选。 如未指定，则使用 Unidrv 提供的默认值。
CyanInYellowDye	从 0 到 1000 的数字值，表示黄色染料中青色污染的百分比。 该值为污染百分比乘以 100。 例如，8.4% 的污染会被指定为 840，10% 为 1000。	可选。 如未指定，则使用 Unidrv 提供的默认值。
EnableGDIColorMapping	TRUE 或 FALSE。 表示 GDI 是否应执行从显示器到打印机颜色空间的色域映射。	可选。 如果未指定，默认值为 FALSE。 如果为 TRUE，则 Unidrv 将在 GDIINFO 结构中设置 HT_FLAG_DO_DEVCLR_XFORM 标志。
MagentaInCyanDye	从 0 到 1000 的数字值，表示青色染料中洋红色污染的百分比。 该值为污染百分比乘以 100。 例如，8.4% 的污染会被指定为 840，10% 为 1000。	可选。 如未指定，则使用 Unidrv 提供的默认值。
MagentaInYellowDye	从 0 到 1000 的数字值，表示黄色染料中洋红色污染的百分比。 该值为污染百分比乘以 100。 例如，8.4% 的污染会被指定为 840，10% 为 1000。	可选。 如未指定，则使用 Unidrv 提供的默认值。
YellowInCyanDye	从 0 到 1000 的数字值，表示情色染料中黄色污染的百分比。 该值为污染百分比乘以 100。 例如，8.4% 的污染会被指定为 840，10% 为 1000。	可选。 如未指定，则使用 Unidrv 提供的默认值。
YellowInMagentaDye	从 0 到 1000 的数字值，表示洋红色染料中黄色污染的百分比。 该值为污染百分比乘以 100。 例如，8.4% 的污染会被指定为 840，10% 为 1000。	可选。 如未指定，则使用 Unidrv 提供的默认值。

当 *ChangeColorModeOnDoc? 颜色属性被设置为 TRUE 时，将启用颜色优化。 如果此属性被设置为 FALSE，则不执行优化。 启用颜色优化后，后台处理程序文件中的颜色会导致后台处理程序文件以彩色显示。 后台处理程序文件中缺少颜色会导致后台处理程序文件以单色显示。

如果要创建 Unidrv 呈现插件来生成彩色水印，那么当彩色水印打印在黑白文档上时，颜色优化会导致彩色水印以黑白打印。 要确保彩色水印与彩色和黑白文档一起正确打印，请禁用颜色优化。

还可以通过设置 ATTRIBUTE_INFO_2 或 ATTRIBUTE_INFO_3 结构中的 dwColorOptimization 成员来控制由 *ChangeColorModeOnDoc? 颜色属性控制的颜色优化。 也可以使用 GdiEndPageEMF 函数控制颜色优化。