Partilhar via

Listas de imagens

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

Visão geral

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

Funções

Tópico Índice
HIMAGELIST_QueryInterface Recupera um ponteiro para um IImageList ou IImageList2 objeto 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 a arrastar 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 arraste na posição especificada dentro da janela.
ImageList_DragLeave Desbloqueia a janela especificada e oculta a imagem arrastada, permitindo que a janela seja atualizada.
ImageList_DragMove Move a imagem que está sendo arrastada durante uma operação de arrastar e soltar. Esta 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 de dispositivo especificado.
ImageList_DrawEx Desenha um item de lista de imagens no contexto de 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 estruturaIMAGELISTDRAWPARAMS.
ImageList_Duplicate Cria uma duplicata de uma lista de imagens existente.
ImageList_EndDrag Encerra uma operação de arrastar.
ImageList_GetBkColor Recupera a cor de plano de fundo atual de uma lista de imagens.
ImageList_GetDragImage Recupera a lista de imagens temporárias usada para arrastar a imagem. A função também recupera a posição de arrasto 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 numa 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 para 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 numa lista de imagens por uma nova imagem.
ImageList_ReplaceIcon Substitui uma imagem por um ícone ou cursor.
ImageList_SetBkColor Define a cor do plano de fundo para 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 arrasto combinando a imagem especificada (normalmente uma imagem do cursor do mouse) com a imagem de arraste 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 anteriores 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 Índice
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 Índice
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.

Metodologia

Tópico Índice
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 a arrastar uma imagem.
Clone Clones 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 arrasto na posição especificada dentro da janela.
DragLeave Desbloqueia a janela especificada e oculta a imagem de arrasto, o que permite que a janela seja atualizada.
DragMove Move a imagem que está sendo arrastada durante uma operação de arrastar e soltar. Esta função é normalmente chamada em resposta a uma mensagem WM_MOUSEMOVE.
DragShowNolock Mostra ou oculta a imagem que está sendo arrastada.
Sorteio Desenha um item de lista de imagens no contexto de 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 arrastar imagem. A função também recupera a posição de arrasto 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 numa 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.
Substitua Substitui uma imagem numa lista de imagens por uma nova imagem.
ReplaceIcon Substitui uma imagem por um ícone ou cursor.
SetBkColor Define a cor do plano de fundo para uma lista de imagens. Esse método só funciona se você adicionar um ícone à lista de imagens ou usar o métodoIImageList::AddMasked para adicionar um bitmap preto e branco. Sem uma máscara, toda a imagem é desenhada e a cor de fundo não é visível.
SetDragCursorImage Cria uma nova imagem de arrasto combinando a imagem especificada, que normalmente é uma imagem do cursor do mouse, com a imagem de arrasto 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 anteriores, 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 Índice
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 é usado com a função IImageList::D raw.
  • Last updated on