Funzione SetPaletteEntries (wingdi.h)

Articolo
08/27/2023

La funzione SetPaletteEntries imposta valori di colore RGB (rosso, verde, blu) e flag in un intervallo di voci in una tavolozza logica.

Sintassi

UINT SetPaletteEntries(
  [in] HPALETTE           hpal,
  [in] UINT               iStart,
  [in] UINT               cEntries,
  [in] const PALETTEENTRY *pPalEntries
);

Parametri

[in] hpal

Handle alla tavolozza logica.

[in] iStart

Prima voce della tavolozza logica da impostare.

[in] cEntries

Numero di voci della tavolozza logica da impostare.

[in] pPalEntries

Puntatore al primo membro di una matrice di strutture PALETTEENTRY contenenti i valori e i flag RGB.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è il numero di voci impostate nel riquadro logico.

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.

Anche se una tavolozza logica è stata selezionata e realizzata, le modifiche apportate alla tavolozza non influiscono sulla tavolozza fisica nella superficie. RealizzarePalette deve essere chiamato di nuovo per impostare la nuova tavolozza logica nella superficie.

Requisiti

Requisito	Valore
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