Compartilhar via


Função ImageList_SetColorTable

Define a tabela de cores para uma lista de imagens.

Sintaxe

int ImageList_SetColorTable(
  _In_ HIMAGELIST himl,
  _In_ int        start,
  _In_ int        len,
  _In_ RGBQUAD    *prgb
);

Parâmetros

himl [in]

Tipo: HIMAGELIST

Um identificador para a lista de imagens.

start [in]

Tipo: int

Um índice de tabela de cores baseado em zero que especifica a primeira entrada de tabela de cores a ser definida.

len [in]

Tipo: int

O número de entradas de tabela de cores a serem definidas.

prgb [in]

Tipo: RGBQUAD*

Um ponteiro para uma matriz de estruturas RGBQUADlen contendo novas informações de cor para a tabela de cores do DIB.

Valor retornado

Tipo: int

Se a função for bem-sucedida, ela retornará o número de entradas de tabela de cores definidas pela função . Se a função falhar, o valor retornado será menor ou igual a zero.

Comentários

Somente as listas de imagens criadas com o sinalizador ILC_COLOR4 ou ILC_COLOR8 têm tabelas de cores. A tabela de cores dessa lista de imagens normalmente é definida automaticamente copiando a tabela de cores da primeira imagem adicionada à lista (por exemplo, por meio da função ImageList_Add ) se essa imagem for um DIB. Se a primeira imagem adicionada à lista de imagens não for um DIB, a tabela de cores da paleta de meio-tom será usada para ILC_COLOR8 listas de imagens e a tabela de cores da VGA será usada para ILC_COLOR4.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
DLL
Comctl32.dll (versão 3.51 ou posterior)

Confira também

Tabela de Cores