Funzione GetPaletteEntries (wingdi.h)
La funzione GetPaletteEntries recupera un intervallo specificato di voci di tavolozza dalla tavolozza logica specificata.
Sintassi
UINT GetPaletteEntries(
[in] HPALETTE hpal,
[in] UINT iStart,
[in] UINT cEntries,
[out] LPPALETTEENTRY pPalEntries
);
Parametri
[in] hpal
Handle alla tavolozza logica.
[in] iStart
Prima voce nella tavolozza logica da recuperare.
[in] cEntries
Numero di voci nel riquadro logico da recuperare.
[out] pPalEntries
Puntatore a una matrice di strutture PALETTEENTRY per ricevere le voci della tavolozza. La matrice deve contenere almeno il numero di strutture specificate dal parametro nEntries .
Valore restituito
Se la funzione ha esito positivo e l'handle nella tavolozza logica è un puntatore valido (non NULL), il valore restituito è il numero di voci recuperate dal tavolozza logica. Se la funzione riesce e gestisce il riquadro logico è NULL, il valore restituito è il numero di voci nel riquadro specificato.
Se la funzione ha esito negativo, il valore restituito è zero.
Commenti
Un'applicazione può determinare se un dispositivo supporta le operazioni del tavolozza chiamando la funzione GetDeviceCaps e specificando la costante RASTERCAPS.
Se il parametro nEntries specifica più voci che esistono nel riquadro, i membri rimanenti della struttura PALETTEENTRY non vengono modificati.
Requisiti
Client minimo supportato | Windows 2000 Professional [solo app desktop] |
Server minimo supportato | Windows 2000 Server [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | wingdi.h (include Windows.h) |
Libreria | Gdi32.lib |
DLL | Gdi32.dll |