Funzione GetDIBColorTable (wingdi.h)

La funzione GetDIBColorTable recupera i valori di colore RGB (rosso, verde, blu) da un intervallo di voci nella tabella dei colori della bitmap di sezione DIB attualmente selezionata in un contesto di dispositivo specificato.

Sintassi

UINT GetDIBColorTable(
  [in]  HDC     hdc,
  [in]  UINT    iStart,
  [in]  UINT    cEntries,
  [out] RGBQUAD *prgbq
);

Parametri

[in] hdc

Handle per un contesto di dispositivo. È necessario selezionare una bitmap di sezione 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 recuperare.

[in] cEntries

Numero di voci della tabella dei colori da recuperare.

[out] prgbq

Puntatore a un buffer che riceve una matrice di strutture di dati RGBQUAD contenenti informazioni sul colore dalla tabella dei colori DIB. Il buffer deve essere sufficientemente grande da contenere tutte le strutture di dati RGBQUAD come valore di cEntries.

Valore restituito

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

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

Commenti

La funzione GetDIBColorTable deve essere chiamata per recuperare la tabella dei colori per le bitmap di sezione DIB che usano 1, 4 o 8 bpp. Il membro biBitCount di una struttura BITMAPINFOHEADER associata specifica il numero di bit per pixel. Le bitmap di sezione DIB con un valore biBitCount maggiore di otto non hanno una tabella dei colori, ma hanno maschere di colore associate. Chiamare la funzione GetObject per recuperare le maschere di colore.

Requisiti

Vedi anche

BITMAPINFOHEADER

Funzioni bitmap

Panoramica delle bitmap

CreateDIBSection

DIBSECTION

Getobject

RGBQUAD

SetDIBColorTable