Compartilhar via


Visão geral do componente ImageList (Windows Forms)

O componente Windows Forms ImageList é usado para armazenar imagens, que podem ser exibidas por controles. Uma lista de imagens permite escrever código para um catálogo de imagens único e consistente. Por exemplo, você pode girar imagens exibidas ImageIndex por um Button controle simplesmente alterando o botão ou ImageKey a propriedade. Você também pode associar a mesma lista de imagem a vários controles. Por exemplo, se você estiver usando um controle e um controle para exibir a mesma lista de arquivos, alterar o ícone de um ListViewTreeView arquivo na lista de imagens fará com que o novo ícone apareça em ambos os modos de exibição.

Usando ImageList com controles

Você pode usar uma lista de imagens com qualquer controle que tenha uma ImageList propriedade — ou, SmallImageList no caso do ListView controle e LargeImageList propriedades. Os controles que podem ser associados a uma lista de imagens incluem: os ListViewcontroles , , , ToolBarTreeView, , , ButtonCheckBoxTabControle . RadioButtonLabel Para associar a lista de imagens a um controle, defina a propriedade do ImageList controle como o nome do ImageList componente.

Principais propriedades

A propriedade key do ImageList componente é Images, que contém as imagens a serem usadas pelo controle associado. Cada imagem individual pode ser acessada pelo seu valor de índice ou por sua chave. A ColorDepth propriedade determina o número de cores com as quais as imagens são renderizadas. As imagens serão todas exibidas no mesmo tamanho, definido pela ImageSize propriedade. Imagens maiores terão a escala ajustada para caber.

Confira também