Función ColorMatchToTarget (wingdi.h)

  • Artículo

La función ColorMatchToTarget permite obtener una vista previa de los colores tal y como aparecerían en el dispositivo de destino.

Sintaxis

BOOL ColorMatchToTarget(
  HDC   hdc,
  HDC   hdcTarget,
  DWORD action
);

Parámetros

hdc

Especifica el contexto del dispositivo para obtener una vista previa, generalmente la pantalla.

hdcTarget

Especifica el contexto del dispositivo de destino, generalmente una impresora.

action

Constante que puede tener uno de los valores siguientes.

 

Valor Significado
CS_ENABLE
 Asigne los colores a la gama de colores del dispositivo de destino. Esto permite la corrección de colores. Todos los comandos de dibujo posteriores en el controlador de dominio representarán los colores tal y como aparecerían en el dispositivo de destino.
CS_DISABLE
 Deshabilite la corrección de colores.
CS_DELETE_TRANSFORM
 Si la administración de colores está habilitada para el perfil de destino, deshabilítela y elimine la transformación concatenada.

Valor devuelto

Si esta función se ejecuta correctamente, el valor devuelto es TRUE.

Si se produce un error en esta función, el valor devuelto es FALSE.

Comentarios

ColorMatchToTarget se puede usar para comprobar los colores de un dispositivo de salida de color en otro dispositivo de salida de color. Al establecer el parámetro uiAction en CS_ENABLE, todos los comandos de dibujo subsiguientes en el controlador de dominio representarán los colores tal y como aparecerían en el dispositivo de destino. Si uiAction está establecido en CS_DISABLE, se desactiva la corrección. Sin embargo, la transformación de color actual no se elimina del controlador de dominio. Está inactivo.

Cuando se llama a ColorMatchToTarget , primero se realiza la transformación de color del dispositivo de destino y, a continuación, se aplica la transformación al dispositivo de vista previa a los resultados de la primera transformación. Esto se usa principalmente para comprobar las condiciones de asignación de la gama. Antes de usar esta función, debe habilitar WCS para ambos contextos de dispositivo.

Esta función no se puede poner en cascada. Aunque la asignación de colores al destino está habilitada estableciendo uiAction en CS_ENABLE, se omiten los cambios de aplicación en el espacio de colores o el método de asignación de gama. Esos cambios surten efecto cuando se deshabilita la asignación de colores al destino.

Nota No se producirá una pérdida de memoria si una aplicación no elimina una transformación mediante CS_DELETE_TRANSFORM. La transformación se eliminará cuando se cierre el contexto del dispositivo (DC) o cuando se elimine el espacio de colores de la aplicación. Sin embargo, si la transformación no se va a volver a usar o si la aplicación no va a realizar ninguna coincidencia de color más en el controlador de dominio, debe eliminar explícitamente la transformación para liberar la memoria que ocupa.
 
El parámetro uiAction solo debe establecerse en CS_DELETE_TRANSFORM si la administración de colores está habilitada antes de llamar a la función ColorMatchToTarget .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wingdi.h
Library Gdi32.lib
Archivo DLL Gdi32.dll

Consulte también