Listas de imagens

Esta seção contém informações sobre os elementos de programação usados com listas de imagens.

Visões gerais

Tópico	Contents
Listas de imagens	Uma lista de imagens é uma coleção de imagens do mesmo tamanho, cada uma das quais pode ser referida por seu índice.

Funções

Tópico	Contents
HIMAGELIST_QueryInterface	Recupera um ponteiro para um objeto IImageList ou IImageList2 que corresponde ao identificador HIMAGELIST da lista de imagens.
ImageList_Add	Adiciona uma imagem ou imagens a uma lista de imagens.
ImageList_AddMasked	Adiciona uma imagem ou imagens a uma lista de imagens, gerando uma máscara a partir do bitmap especificado.
ImageList_BeginDrag	Começa arrastando uma imagem.
ImageList_CoCreateInstance	Cria uma única instância de uma imagelist e retorna um ponteiro de interface para ela.
ImageList_Copy	Copia imagens dentro de uma determinada lista de imagens.
ImageList_Create	Cria uma nova lista de imagens.
ImageList_Destroy	Destrói uma lista de imagens.
ImageList_DragEnter	Exibe a imagem de arrastar na posição especificada dentro da janela.
ImageList_DragLeave	Desbloqueia a janela especificada e oculta a imagem de arraste, permitindo que a janela seja atualizada.
ImageList_DragMove	Move a imagem que está sendo arrastada durante uma operação do tipo "arrastar e soltar". Essa função é normalmente chamada em resposta a uma mensagem WM_MOUSEMOVE .
ImageList_DragShowNolock	Mostra ou oculta a imagem que está sendo arrastada.
ImageList_Draw	Desenha um item da lista de imagens no contexto do dispositivo especificado.
ImageList_DrawEx	Desenha um item da lista de imagens no contexto do dispositivo especificado. A função usa o estilo de desenho especificado e combina a imagem com a cor especificada.
ImageList_DrawIndirect	Desenha uma imagem de lista de imagens com base em uma estrutura IMAGELISTDRAWPARAMS.
ImageList_Duplicate	Cria uma duplicata de uma lista de imagens existente.
ImageList_EndDrag	Encerra uma operação de arrastar.
ImageList_GetBkColor	Recupera a cor da tela de fundo atual para uma lista de imagens.
ImageList_GetDragImage	Recupera a lista de imagens temporárias usada para a imagem de arraste. A função também recupera a posição de arrastar atual e o deslocamento da imagem de arrasto em relação à posição de arrastar.
ImageList_GetIcon	Cria um ícone a partir de uma imagem e máscara em uma lista de imagens.
ImageList_GetIconSize	Recupera as dimensões das imagens em uma lista de imagens. Todas as imagens em uma lista de imagens têm as mesmas dimensões.
ImageList_GetImageCount	Recupera o número de imagens em uma lista de imagens.
ImageList_GetImageInfo	Recupera informações sobre uma imagem.
ImageList_LoadImage	Cria uma lista de imagens a partir do bitmap especificado.
ImageList_Merge	Cria uma nova imagem combinando duas imagens existentes. A função também cria uma nova lista de imagens na qual armazenar a imagem.
ImageList_Read	Lê uma lista de imagens de um fluxo.
ImageList_ReadEx	Lê uma lista de imagens de um fluxo e retorna uma interface para a lista de imagens.
ImageList_Remove	Remove uma imagem de uma lista de imagens.
ImageList_Replace	Substitui uma imagem em uma lista de imagens por uma nova imagem.
ImageList_ReplaceIcon	Substitui uma imagem por um ícone ou cursor.
ImageList_SetBkColor	Define a cor da tela de fundo de uma lista de imagens. Essa função só funciona se você adicionar um ícone ou usar ImageList_AddMasked com um bitmap preto e branco. Sem máscara, toda a imagem é desenhada; portanto, a cor de fundo não é visível.
ImageList_SetColorTable	Define a tabela de cores para uma lista de imagens.
ImageList_SetDragCursorImage	Cria uma nova imagem de arrastar combinando a imagem especificada (normalmente uma imagem do cursor do mouse) com a imagem de arrastar atual.
ImageList_SetIconSize	Define as dimensões das imagens em uma lista de imagens e remove todas as imagens da lista.
ImageList_SetImageCount	Redimensiona uma lista de imagens existente.
ImageList_SetOverlayImage	Adiciona uma imagem especificada à lista de imagens a serem usadas como máscaras de sobreposição. Uma lista de imagens pode ter até quatro máscaras de sobreposição na versão 4.70 e anterior e até 15 na versão 4.71. A função atribui um índice de máscara de sobreposição à imagem especificada.
ImageList_Write	Grava uma lista de imagens em um fluxo.
ImageList_WriteEx	Grava uma lista de imagens em um fluxo.

Macros

Tópico	Contents
ImageList_AddIcon	Adiciona um ícone ou cursor a uma lista de imagens. ImageList_AddIcon chama a função ImageList_ReplaceIcon.
ImageList_ExtractIcon	Chama a função ImageList_GetIcon para criar um ícone ou cursor com base em uma imagem e máscara em uma lista de imagens.
ImageList_LoadBitmap	Chama a função ImageList_LoadImage para criar uma lista de imagens a partir do recurso de bitmap especificado.
ImageList_RemoveAll	Chama a função ImageList_Remove para remover todas as imagens de uma lista de imagens.
INDEXTOOVERLAYMASK	Prepara o índice de uma máscara de sobreposição para que a função ImageList_Draw possa usá-la.

Interfaces

Tópico	Contents
IImageList	Expõe métodos que manipulam e interagem com listas de imagens. Para usar IImageList, especifique Comctl32.dll versão 6 no manifesto. Se você não fizer isso, Comctl32.dll versão 5 será usada por padrão, com a qual IImageList pode exibir um comportamento imprevisível. Para obter mais informações sobre manifestos, consulte Habilitando estilos visuais.

Métodos

Tópico	Contents
Adicionar	Adiciona uma imagem ou imagens a uma lista de imagens.
AddMasked	Adiciona uma imagem ou imagens a uma lista de imagens, gerando uma máscara a partir do bitmap especificado.
BeginDrag	Começa arrastando uma imagem.
Clonar	Clona uma lista de imagens existente.
Copy	Copia imagens de uma determinada lista de imagens.
DragEnter	Bloqueia atualizações para a janela especificada durante uma operação de arrastar e exibe a imagem de arrastar na posição especificada dentro da janela.
DragLeave	Desbloqueia a janela especificada e oculta a imagem de arraste, o que permite que a janela seja atualizada.
ArrastarMover	Move a imagem que está sendo arrastada durante uma operação do tipo "arrastar e soltar". Essa função é normalmente chamada em resposta a uma mensagem WM_MOUSEMOVE .
DragShowNolock	Mostra ou oculta a imagem que está sendo arrastada.
Desenhar	Desenha um item da lista de imagens no contexto do dispositivo especificado.
EndDrag	Encerra uma operação de arrastar.
GetBkColor	Obtém a cor de plano de fundo atual para uma lista de imagens.
GetDragImage	Obtém a lista de imagens temporárias usada para a imagem de arraste. A função também recupera a posição de arrastar atual e o deslocamento da imagem de arrasto em relação à posição de arrastar.
GetIcon	Cria um ícone a partir de uma imagem e uma máscara em uma lista de imagens.
GetIconSize	Obtém as dimensões das imagens em uma lista de imagens. Todas as imagens em uma lista de imagens têm as mesmas dimensões.
GetImageCount	Obtém o número de imagens em uma lista de imagens.
GetImageInfo	Obtém informações sobre uma imagem.
GetImageRect	Obtém o retângulo delimitador de uma imagem.
GetItemFlags	Obtém os sinalizadores de uma imagem.
GetOverlayImage	Recupera uma imagem especificada da lista de imagens usadas como máscaras de sobreposição.
Mesclar	Cria uma nova imagem combinando duas imagens existentes. Esse método também cria uma nova lista de imagens na qual armazenar a imagem.
Remover	Remove uma imagem de uma lista de imagens.
Replace	Substitui uma imagem em uma lista de imagens por uma nova imagem.
ReplaceIcon	Substitui uma imagem por um ícone ou cursor.
SetBkColor	Define a cor da tela de fundo de uma lista de imagens. Esse método só funciona se você adicionar um ícone à lista de imagens ou usar o método IImageList::AddMasked para adicionar um bitmap preto e branco. Sem uma máscara, a imagem inteira é desenhada e a cor do plano de fundo não fica visível.
SetDragCursorImage	Cria uma nova imagem de arrastar combinando a imagem especificada, que normalmente é uma imagem do cursor do mouse, com a imagem de arrastar atual.
SetIconSize	Define as dimensões das imagens em uma lista de imagens e remove todas as imagens da lista.
SetImageCount	Redimensiona uma lista de imagens existente.
SetOverlayImage	Adiciona uma imagem especificada à lista de imagens usadas como máscaras de sobreposição. Uma lista de imagens pode ter até quatro máscaras de sobreposição no Common Controls versão 4.70 e anterior e até 15 na versão 4.71 ou posterior. O método atribui um índice de máscara de sobreposição à imagem especificada.

Estruturas

Tópico	Contents
IMAGEINFO	Contém informações sobre uma imagem em uma lista de imagens. Essa estrutura é usada com a função IImageList::GetImageInfo.
IMAGELISTDRAWPARAMS	Contém informações sobre uma operação de desenho de lista de imagens e é usado com a função IImageList::D raw .