Partager via


GetNearestPaletteIndex, fonction (wingdi.h)

La fonction GetNearestPaletteIndex récupère l’index de l’entrée dans la palette logique spécifiée qui correspond le plus à une valeur de couleur spécifiée.

Syntaxe

UINT GetNearestPaletteIndex(
  [in] HPALETTE h,
  [in] COLORREF color
);

Paramètres

[in] h

Handle d’une palette logique.

[in] color

Couleur à mettre en correspondance. Pour créer une valeur de couleur COLORREF , utilisez la macro RVB .

Valeur retournée

Si la fonction réussit, la valeur de retour est l’index d’une entrée dans une palette logique.

Si la fonction échoue, la valeur de retour sera CLR_INVALID.

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.

Si la palette logique donnée contient des entrées avec l’indicateur PC_EXPLICIT défini, la valeur de retour n’est pas définie.

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

COLORREF

Fonctions de couleur

Vue d’ensemble des couleurs

GetDeviceCaps

GetNearestColor

GetPaletteEntries

GetSystemPaletteEntries

RGB