Funzione SetDIBColorTable (wingdi.h)

Articolo
08/27/2023

La funzione SetDIBColorTable imposta i valori di colore RGB (rosso, verde, blu) in un intervallo di voci nella tabella dei colori del DIB attualmente selezionato in un contesto di dispositivo specificato.

Sintassi

UINT SetDIBColorTable(
  [in] HDC           hdc,
  [in] UINT          iStart,
  [in] UINT          cEntries,
  [in] const RGBQUAD *prgbq
);

Parametri

[in] hdc

Contesto di dispositivo. È necessario selezionare un DIB in questo contesto di dispositivo.

[in] iStart

Indice della tabella dei colori in base zero che specifica la prima voce della tabella dei colori da impostare.

[in] cEntries

Numero di voci della tabella dei colori da impostare.

[in] prgbq

Puntatore a una matrice di strutture RGBQUAD contenenti nuove informazioni sul colore per la tabella dei colori di DIB.

Valore restituito

Se la funzione ha esito positivo, il valore restituito corrisponde al numero di voci della tabella dei colori impostate dalla funzione.

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

Questa funzione deve essere chiamata per impostare la tabella dei colori per i DATABASE che usano 1, 4 o 8 bpp. Membro BitCount della struttura di intestazione delle informazioni bitmap associata di una bitmap.

La struttura BITMAPINFOHEADER specifica il numero di bit per pixel. Le bitmap indipendenti dal dispositivo con un valore biBitCount maggiore di 8 non hanno una tabella dei colori.

Il membro bV5BitCount della struttura di BITMAPV5HEADER associata a una bitmap specifica il numero di bit per pixel. Le bitmap indipendenti dal dispositivo con un valore bV5BitCount maggiore di 8 non hanno una tabella colori.

ICM: Non viene eseguita alcuna gestione dei colori.

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