GetDIBColorTable

9/9/2008

Essa função recupera valores cor vermelho, verde e azul de um intervalo de entradas na tabela de cores da device-independent bitmap (bitmap independente de dispositivo (DIB)) que está selecionado em um contexto dispositivo especificado.

Syntax

WINGDIAPI UINT WINAPI GetDIBColorTable(
  HDC hdc,
  UINT uStartIndex,
  UINT cEntries,
  RGBQUAD* pColors
);

Parameters

• hDC
  [no] Identificador para um contexto dispositivo.

  Um bitmap independente de dispositivo (DIB) deve ser selecionada para este contexto dispositivo.

• uStartIndex
  [no] Inteiro não assinado que que especifica um índice com base zero da primeira entrada tabela de cores que desejar para recuperar.

• cEntries
  [no] Inteiro sem sinal que especifica o número de entradas tabela de cores que desejar para recuperar.

• pColors
  [out] Ponteiro para uma reserva que recebe uma matriz de RGBQUAD estruturas que contêm informações cor a partir de tabela de cores bitmap independente de dispositivo (DIB).

  Você deve especificar uma reserva que é grande o suficiente para conter quantos RGBQUAD Estruturas como o valor de cEntries.

Return Value

O número de entradas tabela de cores que a função recuperada indica sucesso.

Zero indica falha.

Para informações de erro estendidas get, chamar GetLastError.

Remarks

Você deve chamar o GetDIBColorTable função para recuperar o tabela de cores para bitmaps seção bitmap independente de dispositivo (DIB) que usar 1, 4 ou 8 bits por pixel (bpp).

O biBitCount membro de um bitmap-associado BITMAPINFOHEADER estrutura especifica o número de bpp.

Bitmaps seção bitmap independente de dispositivo (DIB) que possuem um biBitCount valor maior do que oito não é necessário um tabela de cores, mas esses bitmaps tiver associado máscaras cor. Chamar o GetObject função para recuperar essas máscaras cor.

Requirements

Header	windows.h
Library	coredll.lib
Windows Embedded CE	Windows CE .NET 4.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

CreateDIBSection
GetObject
SetDIBColorTable
BITMAPINFOHEADER
DIBSECTION
RGBQUAD