Compartilhar via


Visão geral do controle ListView (Windows Forms)

O controle ListView do Windows Forms exibe uma lista de itens com ícones. Você pode 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, List e Details.

O que você pode fazer com o controle ListView

Observação

Um modo de exibição adicional, Bloco, só está disponível no Windows XP e no sistema operacional Windows Server 2003. Para obter mais informações, consulte Como ativar a exibição em blocos em um controle ListView do 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 é o mesmo, exceto pelo fato de exibir ícones pequenos. O modo Lista exibe ícones pequenos, mas está sempre em uma única coluna. O modo 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 propriedade View. Todos os modos de exibição podem exibir imagens de listas de imagens. Para obter detalhes, consulte Como exibir ícones para o controle ListView dos Windows Forms.

A tabela a seguir lista alguns dos membros ListView e as exibições nas quais 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 Todos os modos de exibição, exceto List
Propriedade HeaderStyle Details.
Propriedade InsertionMark LargeIcon, SmallIcon ou Tile

A propriedade chave do controle ListView é Items, que contém os itens exibidos pelo controle. A propriedade SelectedItems 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 propriedade MultiSelect estiver definida como true. O controle ListView poderá exibir caixas de seleção ao lado dos itens, se a propriedade CheckBoxes estiver definida como true.

A propriedade Activation 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. A ativação OneClick requer um único clique para ativar o item. A ativação do TwoClick requer que o usuário clique duas vezes para ativar o item; um único clique altera a cor do texto do item. Standard ativação requer que o usuário clique duas vezes para ativar um item, mas o item não altera a aparência.

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

Consulte também