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

Confira também

BITMAPINFOHEADER

Funções bitmap

Visão geral do Bitmaps

Createdibsection

DIBSECTION

GetDIBColorTable

Getobject

RGBQUAD