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

Vedi anche

Funzioni colore

Panoramica dei colori

GetDeviceCaps

GetSystemPaletteEntries

PALETTEENTRY

SetPaletteEntries