GetPaletteEntries, fonction (wingdi.h)

Article
08/27/2023

La fonction GetPaletteEntries récupère une plage spécifiée d’entrées de palette à partir de la palette logique donnée.

Syntaxe

UINT GetPaletteEntries(
  [in]  HPALETTE       hpal,
  [in]  UINT           iStart,
  [in]  UINT           cEntries,
  [out] LPPALETTEENTRY pPalEntries
);

Paramètres

[in] hpal

Handle de la palette logique.

[in] iStart

Première entrée de la palette logique à récupérer.

[in] cEntries

Nombre d’entrées dans la palette logique à récupérer.

[out] pPalEntries

Pointeur vers un tableau de structures PALETTEENTRY pour recevoir les entrées de palette. Le tableau doit contenir au moins autant de structures que spécifié par le paramètre nEntries .

Valeur retournée

Si la fonction réussit et que le handle de la palette logique est un pointeur valide (et non NULL), la valeur de retour est le nombre d’entrées récupérées à partir de la palette logique. Si la fonction réussit et que le handle dans la palette logique est NULL, la valeur de retour est le nombre d’entrées dans la palette donnée.

Si la fonction échoue, la valeur de retour est égale à zéro.

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 le paramètre nEntries spécifie plus d’entrées qu’il n’en existe dans la palette, les membres restants de la structure PALETTEENTRY ne sont pas modifiés.

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