Función UpdateColors (wingdi.h)

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

Sintaxis

BOOL UpdateColors(
  [in] HDC hdc
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

Una aplicación puede determinar si un dispositivo admite operaciones de paleta llamando a la función GetDeviceCaps y especificando la constante RASTERCAPS.

Una ventana inactiva con una paleta lógica realizada puede llamar a UpdateColors como alternativa a volver a dibujar su área cliente cuando cambia la paleta del sistema.

La función UpdateColors normalmente actualiza un área de cliente más rápido que volver a dibujar el área. Sin embargo, dado que UpdateColors realiza la traducción de colores en función del color de cada píxel antes de cambiar la paleta del sistema, cada llamada a esta función produce la pérdida de cierta precisión del color.

Se debe llamar a esta función poco después de recibir un mensaje de WM_PALETTECHANGED .

Requisitos

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 (incluye Windows.h)
Library	Gdi32.lib
Archivo DLL	Gdi32.dll

Consulte también

Funciones de color

Introducción a los colores

GetDeviceCaps

RealizePalette