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. |