Fonction SelectPalette (wingdi.h)
La fonction SelectPalette sélectionne la palette logique spécifiée dans un contexte d’appareil.
Syntaxe
HPALETTE SelectPalette(
[in] HDC hdc,
[in] HPALETTE hPal,
[in] BOOL bForceBkgd
);
Paramètres
[in] hdc
Handle dans le contexte de l’appareil.
[in] hPal
Handle de la palette logique à sélectionner.
[in] bForceBkgd
Spécifie si la palette logique est forcée d’être une palette d’arrière-plan. Si cette valeur est TRUE, la fonction RealizePalette permet de mapper la palette logique aux couleurs déjà présentes dans la palette physique de la meilleure façon possible. Cette opération est toujours effectuée, même si la fenêtre pour laquelle la palette est réalisée appartient à un thread sans focus actif.
Si cette valeur est FALSE, RealizePalette entraîne la copie de la palette logique dans la palette d’appareils lorsque l’application est au premier plan. (Si le paramètre hdc est un contexte d’appareil mémoire, ce paramètre est ignoré.)
Valeur retournée
Si la fonction réussit, la valeur de retour est un handle de la palette logique précédente du contexte d’appareil.
Si la fonction échoue, la valeur de retour est NULL.
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 application peut sélectionner une palette logique dans plusieurs contextes d’appareil uniquement si les contextes d’appareil sont compatibles. Sinon , SelectPalette échoue. Pour créer un contexte d’appareil compatible avec un autre contexte d’appareil, appelez CreateCompatibleDC avec le premier contexte d’appareil comme paramètre. Si une palette logique est sélectionnée dans plusieurs contextes d’appareil, les modifications apportées à la palette logique affectent tous les contextes d’appareil pour lesquels elle est sélectionnée.
Une application peut appeler la fonction SelectPalette avec le paramètre bForceBackground défini sur TRUE si les fenêtres enfants d’une fenêtre de niveau supérieur réalisent chacune leurs propres palettes. Toutefois, seule la fenêtre enfant qui doit réaliser sa palette doit définir bForceBackground sur TRUE ; les autres fenêtres enfants doivent définir cette valeur sur FALSE.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 |