Funzione GetDIBColorTable (wingdi.h)

Articolo
03/04/2024

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

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