Fonction RealizePalette (wingdi.h)

La fonction RealizePalette mappe les entrées de la palette logique actuelle à la palette système.

Syntaxe

UINT RealizePalette(
  [in] HDC hdc
);

Paramètres

[in] hdc

Handle du contexte d’appareil dans lequel une palette logique a été sélectionnée.

Valeur retournée

Si la fonction réussit, la valeur de retour correspond au nombre d’entrées de la palette logique mappée à la palette système.

Si la fonction échoue, la valeur de retour est GDI_ERROR.

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.

La fonction RealizePalette modifie la palette de l’appareil associé au contexte d’appareil spécifié. Si le contexte de l’appareil est un contrôleur de domaine mémoire, la table de couleurs de l’image bitmap sélectionnée dans le contrôleur de domaine est modifiée. Si le contexte de l’appareil est un contrôleur de domaine d’affichage, la palette physique de cet appareil est modifiée.

Une palette logique est une mémoire tampon entre les applications gourmandes en couleurs et le système, ce qui permet à ces applications d’utiliser autant de couleurs que nécessaire sans interférer avec les couleurs affichées par d’autres fenêtres.

Quand la fenêtre d’une application a le focus et qu’elle appelle la fonction RealizePalette , le système tente de réaliser autant de couleurs que possible. Il en va de même pour les applications avec des fenêtres inactives.

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

CreatePalette

GetDeviceCaps

SélectionnerPalette