Função GetDIBColorTable (wingdi.h)

Artigo
03/04/2024

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