Compartilhar via

Listas de imagens

  • Artigo

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 .