Função SetDIBColorTable (wingdi.h)
A função SetDIBColorTable define valores de cor RGB (vermelho, verde, azul) em um intervalo de entradas na tabela de cores do DIB que está selecionado atualmente em um contexto de dispositivo especificado.
Sintaxe
UINT SetDIBColorTable(
[in] HDC hdc,
[in] UINT iStart,
[in] UINT cEntries,
[in] const RGBQUAD *prgbq
);
Parâmetros
[in] hdc
Um contexto de dispositivo. Um 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 definida.
[in] cEntries
O número de entradas de tabela de cores a serem definidas.
[in] prgbq
Um ponteiro para uma matriz de estruturas RGBQUAD que contêm novas informações de cor para a tabela de cores do DIB.
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 define.
Se a função falhar, o valor retornado será zero.
Comentários
Essa função deve ser chamada para definir a tabela de cores para DIBs que usam 1, 4 ou 8 bpp. O membro BitCount da estrutura de cabeçalho de informações de bitmap associada de um bitmap.
A estrutura BITMAPINFOHEADER especifica o número de bits por pixel. Bitmaps independentes do dispositivo com um valor biBitCount maior que 8 não têm uma tabela de cores.
O membro bV5BitCount da estrutura de BITMAPV5HEADER associada de um bitmap especifica o número de bits por pixel. Bitmaps independentes do dispositivo com um valor bV5BitCount maior que 8 não têm uma tabela de cores.
ICM: Nenhum gerenciamento de cores é executado.
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 |