Partilhar via

Visão geral do componente ImageList (Windows Forms)

  • Artigo

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

Usando ImageList com controles

Você pode usar uma lista de imagens com qualquer controlo que tenha uma propriedade ImageList — ou, no caso do controlo ListView, propriedades SmallImageList e LargeImageList. Os controles que podem ser associados a uma lista de imagens incluem: os controles ListView, TreeView, ToolBar, TabControl, Button, CheckBox, RadioButtone Label. Para associar a lista de imagens a um controle, defina a propriedade ImageList do controle como o nome do componente ImageList.

Principais propriedades

A propriedade chave do componente ImageList é Images, que contém as imagens a serem usadas pelo controle associado. Cada imagem individual pode ser acessada por seu valor de índice ou por sua chave. A propriedade ColorDepth 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 propriedade ImageSize. As imagens maiores serão dimensionadas para se ajustarem.

Ver também