Compartilhar via


Visão geral do controle ListView (Windows Forms)

O controle ListView do Windows Forms exibe uma lista de itens com ícones. É possível usar uma exibição de lista para criar uma interface do usuário, como o painel direito do Windows Explorer. O controle tem quatro modos de exibição: LargeIcon, SmallIcon, Lista e Detalhes.

O que você pode fazer com o Controle ListView

Observação

O “organizar lado a lado”, um modo de exibição adicional, está disponível apenas nos sistemas operacionais Windows XP e Windows Server 2003. Para obter mais informações, consulte Como Habilitar a Exibição Lado a Lado em um Controle ListView dos Windows Forms.

O modo LargeIcon exibe ícones grandes ao lado do texto do item; os itens aparecerão em várias colunas se o controle for grande o suficiente. O modo SmallIcon funciona da mesma forma, mas exibe ícones pequenos. O modo de Lista exibe ícones pequenos, mas sempre em uma única coluna. O modo de Detalhes exibe itens em várias colunas. Para obter detalhes, consulte Como Adicionar Colunas ao Controle ListView dos Windows Forms. O modo de exibição é determinado pela View propriedade. Todos os modos de exibição podem exibir imagens de listas de imagens. Para obter detalhes, consulte Como Exibir Ícones do Controle ListView dos Windows Forms.

A tabela a ListView seguir lista alguns dos membros e os modos de exibição em que eles são válidos.

Membro do ListView Visualizar
Propriedade Alignment SmallIcon ou LargeIcon
Propriedade AutoArrange SmallIcon ou LargeIcon
Método AutoResizeColumn Details
Propriedade Columns Details ou Tile
Evento DrawSubItem Details
Método FindItemWithText Details, List ou Tile
Método FindNearestItem SmallIcon ou LargeIcon
Método GetItemAt Details ou Tile
Propriedade Groups Todas as visualizações, exceto List
Propriedade HeaderStyle Details.
Propriedade InsertionMark LargeIcon, SmallIcon ou Tile

A propriedade key do ListView controle é Items, que contém os itens exibidos pelo controle. A SelectedItems propriedade contém uma coleção dos itens atualmente selecionados no controle. O usuário pode selecionar vários itens, por exemplo, para arrastar e soltar vários itens de cada vez para outro controle, se a MultiSelect propriedade estiver definida como true. O ListView controle pode exibir caixas de seleção ao lado dos itens, se a CheckBoxes propriedade estiver definida como true.

A Activation propriedade determina que tipo de ação o usuário deve executar para ativar um item na lista: as opções são Standard, OneClicke TwoClick. OneClick A ativação requer um único clique para ativar o item. TwoClick A ativação requer que o usuário clique duas vezes para ativar o item; Um único clique altera a cor do texto do item. Standard A ativação requer que o usuário clique duas vezes para ativar um item, mas o item não altera a aparência.

O ListView controle também oferece suporte aos estilos visuais e outros recursos disponíveis na plataforma Windows XP, incluindo agrupamento, exibição de bloco e marcas de inserção.

Confira também