GetPaletteEntries, fonction (wingdi.h)
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 |