Função SetDIBColorTable (wingdi.h)

Artigo
03/13/2024

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