Condividi tramite


Funzione SetDIBColorTable (wingdi.h)

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

Vedi anche

BITMAPINFOHEADER

Funzioni bitmap

Panoramica delle bitmap

CreateDIBSection

DIBSECTION

GetDIBColorTable

Getobject

RGBQUAD