ColorMatchToTarget功能可以启用或禁用指定设备上下文的预览。启用预览时，会显示指定设备上下文的后续输出中的颜色，因为它们将显示在目标设备上。这对于检查目标在图像中映射指定颜色的效果非常有用。要启用预览，必须为目标和预览设备上下文启用图像颜色匹配。
BOOL ColorMatchToTarget(
| HDC 【HDC】, | |
| HDC 【处理目标设备的设备上下文。】,【】 | |
| DWORD 【uiAction】 | |
| ); |
参数
【HDC】
处理设备上下文以用于预览，通常是显示。
【处理目标设备的设备上下文。】
处理目标设备上下文，通常是打印机。
【uiAction】
此参数可以具有以下值之一：
| 值 | 含义 |
| CS_ENABLE | 启用预览;在显示之前，通过目标开始匹配颜色。 |
| CS_DISABLE | 禁用预览;通过目标停止匹配颜色，并恢复预览设备的上一个方法。 |
| CS_DELETE_TRANSFORM | 禁用预览并删除用于预览的颜色转换。 |
返回值
如果函数成功，返回值不为零。
如果函数失败，返回值为零。
备注
如果您使用ColorMatchToTarget功能启用预览，则下次调用此函数必须禁用预览;您必须【不】嵌套呼叫才能启用预览。预览启用后，您对颜色空间或色域匹配方法所做的任何更改都将被暂时忽略，但在禁用预览时会生效。
此函数创建一个颜色转换，首先翻译目标设备的颜色，然后翻译预览设备的颜色。您不需要使用CS_DELETE_TRANSFORM删除颜色转换，因为当系统中删除任何一种设备时，或者在删除颜色空间时系统会删除该转换。但是，如果不再使用转换，应用程序可以释放它所占用的空间。
