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 |