Compartilhar via

Visão geral do componente ImageList (Windows Forms)

O componente do Windows Forms ImageList é 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 Button controle 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 ListView controle e um TreeView controle 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 os Controles

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

Propriedades Principais

A propriedade chave do ImageList componente é 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 ColorDepth propriedade determina o número de cores com as quais as imagens são renderizadas. Todas as imagens serão exibidas no mesmo tamanho, definido pela propriedade ImageSize. As imagens maiores serão dimensionadas para caber.

Consulte também

  • Last updated on