UpdateColors

La función UpdateColors actualiza el área de cliente del contexto de dispositivo especificado remapeando los colores actuales en el área de cliente a la paleta lógica actualmente activa.

Sintaxis

BOOL UpdateColors(
    HDC hdc  // manipulador de contexto de dispositivo 
   );

Parámetros

hdc: identifica el contexto de dispositivo.

Valor de retorno

Si la función tiene éxito, el valor de retorno es TRUE.

Si la función falla, el valor de retorno es FALSE. Para obtener mayor información sobre el error, llamar a GetLastError.

Observaciones

Para determinar si un dispositivo soporta operaciones de paleta se puede usar la función GetDeviceCaps, especificando la constante RASTERCAPS.

Una ventana inactiva con una paleta lógica activada puede llamar a UpdateColors como una alternativa a actualizar su área de cliente cuando la paleta de sistema cambie.

La función UpdateColors normalmente actualiza un área de cliente más rápido que el repintado del área. Sin embargo, como UpdateColors realiza una traslación de colores basada en el color de cada pixel antes de que la paleta del sistema fuese cambiada, cada llamada a esta función provoca una pérdida de precisión de color.

Esta función debe ser llamada después de la recepción de un mensaje WM_PALETTECHANGED.