Compartilhar via

Visão geral do componente ImageList (Windows Forms)

  • Artigo

O componente ImageList do Windows Forms é usado para armazenar imagens, que podem ser exibidas por controles. Uma lista de imagens permite que você escreva código para um único catálogo 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 controle que tenha uma propriedade ImageList — ou, no caso do controle ListView, com as 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.

Propriedades principais

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. Todas as imagens serão exibidas no mesmo tamanho, definidas pela propriedade ImageSize. As imagens maiores serão dimensionadas para caber.

Consulte também