UpdateColors, fonction (wingdi.h)

La fonction UpdateColors met à jour la zone cliente du contexte d’appareil spécifié en remappage des couleurs actuelles dans la zone cliente vers la palette logique actuellement réalisée.

Syntaxe

BOOL UpdateColors(
  [in] HDC hdc
);

Paramètres

[in] hdc

Handle dans le contexte de l’appareil.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro.

Remarques

Une application peut déterminer si un appareil prend en charge les opérations de palette en appelant la fonction GetDeviceCaps et en spécifiant la constante RASTERCAPS.

Une fenêtre inactive avec une palette logique réalisée peut appeler UpdateColors comme alternative au redessinage de sa zone cliente lorsque la palette système change.

La fonction UpdateColors met généralement à jour une zone client plus rapidement que le redessinage de la zone. Toutefois, étant donné que UpdateColors effectue la traduction des couleurs en fonction de la couleur de chaque pixel avant que la palette système ne change, chaque appel à cette fonction entraîne la perte d’une certaine précision des couleurs.

Cette fonction doit être appelée peu après la réception d’un message WM_PALETTECHANGED .

Configuration requise

Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wingdi.h (inclure Windows.h)
Bibliothèque	Gdi32.lib
DLL	Gdi32.dll

Voir aussi

Fonctions de couleur

Vue d’ensemble des couleurs

GetDeviceCaps

RéaliserPalette