GetSystemPaletteUse, fonction (wingdi.h)

La fonction GetSystemPaletteUse récupère l’état actuel de la palette système (physique) pour le contexte d’appareil (DC) spécifié.

Syntaxe

UINT GetSystemPaletteUse(
  [in] HDC hdc
);

Paramètres

[in] hdc

Handle pour le contexte de l’appareil.

Valeur retournée

Si la fonction réussit, la valeur de retour est l’état actuel de la palette système. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
SYSPAL_NOSTATIC	La palette système ne contient aucune couleur statique à l’exception du noir et du blanc.
SYSPAL_STATIC	La palette système contient des couleurs statiques qui ne changent pas lorsqu’une application réalise sa palette logique.
SYSPAL_ERROR	Le contexte d’appareil donné n’est pas valide ou ne prend pas en charge une palette de couleurs.

Remarques

Par défaut, la palette système contient 20 couleurs statiques qui ne sont pas modifiées lorsqu’une application réalise sa palette logique. Une application peut accéder à la plupart de ces couleurs en appelant la fonction SetSystemPaletteUse .

Le contexte de l’appareil identifié par le paramètre hdc doit représenter un appareil qui prend en charge les palettes de couleurs.

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

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

Voir aussi

Fonctions de couleur

Vue d’ensemble des couleurs

GetDeviceCaps

SetSystemPaletteUse