Partilhar via


Visão geral do controle ListView (Windows Forms)

O controle Windows Forms ListView exibe uma lista de itens com ícones. Pode utilizar uma vista de lista para criar uma interface de utilizador como o painel direito do Explorador do Windows. O controle tem quatro modos de visualização: LargeIcon, SmallIcon, List e Details.

O que você pode fazer com o controle ListView

Observação

Um modo de exibição adicional, Tile, só está disponível no Windows XP e no sistema operacional Windows Server 2003. Para mais informações, consulte Como ativar a vista de mosaico num controlo ListView do Windows Forms.

O modo LargeIcon exibe ícones grandes ao lado do texto do item; Os itens aparecem em várias colunas se o controle for grande o suficiente. O modo SmallIcon é o mesmo, exceto que exibe í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 do Windows Forms. O modo de exibição é determinado pela propriedade View. Todos os modos de visualização podem exibir imagens de listas de imagens. Para obter detalhes, consulte Como exibir ícones para o controle ListView do Windows Forms.

A tabela a seguir lista alguns dos membros ListView e as visualizações em que são válidos.

Elemento ListView Vista
Alignment propriedade SmallIcon ou LargeIcon
AutoArrange propriedade SmallIcon ou LargeIcon
Método AutoResizeColumn Details
Columns propriedade Details ou Tile
DrawSubItem evento Details
Método FindItemWithText Details, Listou Tile
Método FindNearestItem SmallIcon ou LargeIcon
Método GetItemAt Details ou Tile
Groups propriedade Todas as visualizações, exceto List
HeaderStyle propriedade Details.
InsertionMark propriedade LargeIcon, SmallIconou Tile

A propriedade chave do elemento de controlo ListView é Items, que contém os itens exibidos por este elemento de controlo. 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 ao mesmo tempo para outro controle, se a propriedade MultiSelect estiver definida como true. O controle ListView pode exibir caixas de seleção ao lado dos itens, se a propriedade CheckBoxes estiver definida como true.

A propriedade Activation determina o tipo de ação que o usuário deve executar para ativar um item na lista: as opções são Standard, OneClicke TwoClick. OneClick a ativação necessita de um único clique para ativar o item. A ativação TwoClick requer que o utilizador faça duplo clique 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 muda de aparência.

O controlo ListView também suporta os estilos visuais e outras funcionalidades disponíveis na plataforma Windows XP, incluindo agrupamento, vista de mosaico e marcas de inserção.

Ver também