Compartilhar via


Como: Agrupar itens em um controle ListView do Windows Forms

Com o recurso de agrupamento da ListView o controle, você pode exibir os conjuntos de itens relacionados em grupos. Esses grupos são separados na tela por cabeçalhos de grupo horizontal que contêm os títulos de grupo. Você pode usar ListView grupos para tornar a navegação grandes listas mais fácil por itens de agrupamento em ordem alfabética, por data, ou qualquer outra lógica agrupamento. A imagem a seguir mostra alguns itens agrupados.

Itens agrupados de ListView

Grupos de ListView

Para ativar o agrupamento, crie primeiro um ou mais grupos no designer ou programaticamente. Após a definição de um grupo, você pode atribuir ListView itens para grupos. Você também pode mover itens de um grupo para outro através de programação.

ObservaçãoObservação

ListViewos grupos estão disponíveis somente em Windows XP Home Edition, Windows XP Professional, Windows Server 2003 quando seu aplicativo chama o Application.EnableVisualStyles método. Em sistemas operacionais anteriores, qualquer código relacionados a grupos não tem efeito e os grupos não aparecerá. Para obter mais informações, consulte ListView.Groups.

Para adicionar grupos

  • Use o Add método o Groups coleção.

    ' Adds a new group that has a left-aligned header
    ListView1.Groups.Add(New ListViewGroup("Group 1", _
     HorizontalAlignment.Left))
    
    // Adds a new group that has a left-aligned header
    listView1.Groups.Add(new ListViewGroup("List item text",
        HorizontalAlignment.Left));
    

Para remover grupos

  • Use o RemoveAt ou Clear método o Groups coleção.

    O RemoveAt método remove um único grupo; o Clear método remove todos os grupos da lista.

    ObservaçãoObservação

    A remoção de um grupo não remove os itens dentro desse grupo.

    ' Removes the first group in the collection.
    ListView1.Groups.RemoveAt(0)
    ' Clears all groups:
    ListView1.Groups.Clear()
    
    // Removes the first group in the collection.
    listView1.Groups.RemoveAt(0);
    // Clears all groups.
    listView1.Groups.Clear();
    

Para atribuir itens a grupos ou mover itens entre grupos

  • Definir o ListViewItem.Group a propriedade de itens individuais.

    ' Adds the first item to the first group
    ListView1.Items.Item(0).Group = ListView1.Groups(0)
    
    // Adds the first item to the first group
    listView1.Items[0].Group = listView1.Groups[0];
    

Consulte também

Tarefas

Como: Adicionar e remover itens com o controle ListView do Windows Forms

Referência

Visão geral do controle ListView (Windows Forms)

ListView

ListView.Groups

ListViewGroup

Conceitos

Recursos do Windows XP e Controles dos Formulários do Windows

Outros recursos

Controle ListView (Windows Forms)