Função GetDIBColorTable (wingdi.h)
A função GetDIBColorTable recupera valores de cor RGB (vermelho, verde, azul) de um intervalo de entradas na tabela de cores do bitmap da seção DIB que está selecionado atualmente em um contexto de dispositivo especificado.
Sintaxe
UINT GetDIBColorTable(
[in] HDC hdc,
[in] UINT iStart,
[in] UINT cEntries,
[out] RGBQUAD *prgbq
);
Parâmetros
[in] hdc
Um identificador para um contexto de dispositivo. Um bitmap de seção DIB deve ser selecionado neste contexto de dispositivo.
[in] iStart
Um índice de tabela de cores baseado em zero que especifica a primeira entrada de tabela de cores a ser recuperada.
[in] cEntries
O número de entradas da tabela de cores a serem recuperadas.
[out] prgbq
Um ponteiro para um buffer que recebe uma matriz de estruturas de dados RGBQUAD que contêm informações de cor da tabela de cores DIB. O buffer deve ser grande o suficiente para conter tantas estruturas de dados RGBQUAD quanto o valor de cEntries.
Retornar valor
Se a função for bem-sucedida, o valor retornado será o número de entradas de tabela de cores que a função recupera.
Se a função falhar, o valor retornado será zero.
Comentários
A função GetDIBColorTable deve ser chamada para recuperar a tabela de cores para bitmaps da seção DIB que usam 1, 4 ou 8 bpp. O membro biBitCount de uma estrutura BITMAPINFOHEADER associada a bitmap especifica o número de bits por pixel. Os bitmaps da seção DIB com um valor biBitCount maior que oito não têm uma tabela de cores, mas têm máscaras de cores associadas. Chame a função GetObject para recuperar essas máscaras de cores.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | wingdi.h (inclua Windows.h) |
| Biblioteca | Gdi32.lib |
| DLL | Gdi32.dll |