Compartilhar via

Listas de imagens

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

Súmulas

Tópico Conteúdo
listas de imagens Uma lista de imagens é uma coleção de imagens do mesmo tamanho, cada uma das quais pode ser referenciada por seu índice.

Funções

Tópico Conteúdo
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 do bitmap especificado.
ImageList_BeginDrag Começa a arrastar uma imagem.
ImageList_CoCreateInstance Cria uma única instância de uma lista de imagens e retorna um ponteiro de interface para ela.
ImageList_Copy Copia imagens em 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 arrastar, permitindo que a janela seja atualizada.
ImageList_DragMove Move a imagem que está sendo arrastada durante uma operação de 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 de lista de imagens no contexto do dispositivo especificado.
ImageList_DrawEx Desenha um item de 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 deIMAGELISTDRAWPARAMS.
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 de uma lista de imagens.
ImageList_GetDragImage Recupera a lista de imagens temporárias usada para a imagem de arrastar. A função também recupera a posição de arrastar atual e o deslocamento da imagem de arrastar em relação à posição de arrastar.
ImageList_GetIcon Cria um ícone 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 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 para uma lista de imagens. Essa função só funcionará se você adicionar um ícone ou usar ImageList_AddMasked com um bitmap preto e branco. Sem uma máscara, a imagem inteira é desenhada; portanto, a cor da tela de fundo não está 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 de 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 Conteúdo
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 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 Conteúdo
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á usado por padrão, com o qual IImageList poderá exibir um comportamento imprevisível. Para obter mais informações sobre manifestos, consulte Habilitando estilos visuais.

Métodos

Tópico Conteúdo
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 do bitmap especificado.
BeginDrag Começa a arrastar uma imagem.
Clonar Clona uma lista de imagens existente.
Copiar 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 arrastar, o que permite que a janela seja atualizada.
DragMove Move a imagem que está sendo arrastada durante uma operação de 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 de lista de imagens no contexto do dispositivo especificado.
de EndDrag Encerra uma operação de arrastar.
GetBkColor Obtém a cor da tela de fundo atual de uma lista de imagens.
GetDragImage Obtém a lista de imagens temporárias usada para a imagem de arrastar. A função também recupera a posição de arrastar atual e o deslocamento da imagem de arrastar em relação à posição de arrastar.
GetIcon Cria um ícone 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.
mesclagem 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.
Substituir 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 para uma lista de imagens. Esse método só funcionará 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 desenha e a cor da tela de fundo não fica visível.
SetDragCursorImage Cria uma nova imagem de arrastar combinando a imagem especificada, que normalmente é uma imagem de 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 em Controles Comuns 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 Conteúdo
IMAGEINFO Contém informações sobre uma imagem em uma lista de imagens. Essa estrutura é usada com a funçãoIImageList::GetImageInfo.
IMAGELISTDRAWPARAMS Contém informações sobre uma operação de desenho de lista de imagens e é usada com a função IImageList::D raw.
  • Last updated on