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