Compartilhar via

Como agrupar itens em um controle ListView dos Windows Forms

  • Artigo

Com o recurso de agrupamento do controle ListView, você pode exibir conjuntos relacionados de itens em grupos. Esses grupos são separados na tela por cabeçalhos de grupo horizontais que contêm os títulos do grupo. Você pode usar ListView grupos para facilitar a navegação em grandes listas agrupando itens em ordem alfabética, por data ou por qualquer outro agrupamento lógico. A imagem a seguir mostra alguns itens agrupados.

Captura de tela de grupos ListView pares e ímpares.

Para habilitar o agrupamento, primeiro você deve criar um ou mais grupos no designer ou programaticamente. Depois que um grupo for definido, você poderá atribuir ListView itens a grupos. Você também pode mover itens de um grupo para outro programaticamente.

Para adicionar grupos

  1. Use o método Add da coleção Groups.

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

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

Para remover grupos

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

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

    Nota

    Remover 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

  1. Defina a propriedade ListViewItem.Group dos itens individuais.

    // Adds the first item to the first group
listView1.Items[0].Group = listView1.Groups[0];

    ' Adds the first item to the first group
ListView1.Items.Item(0).Group = ListView1.Groups(0)

Consulte também