Exportar (0) Imprimir
Expandir Tudo
Este artigo foi traduzido por máquina. Coloque o ponteiro do mouse sobre as frases do artigo para ver o texto original. Mais informações.
Tradução
Original

Propriedade ListViewItem.Group

Obtém ou define o grupo ao qual o item está atribuído.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (em System.Windows.Forms.dll)

public ListViewGroup Group { get; set; }

Valor de propriedade

Tipo: System.Windows.Forms.ListViewGroup
O ListViewGroup para a qual o item é atribuído.

Use esta propriedade para definir o grupo ao qual um item pertence. Você também pode definir o grupo na ListViewItem construtor, ou você pode usar essa propriedade para modificar a participação de grupo em tempo de execução. Se você definir essa propriedade como null e há grupos a ListView.Groups coleção, o item será exibido no grupo padrão, que tem o rótulo de cabeçalho "DefaultGroupSystem.Windows.Forms". O grupo padrão não constar o ListView.Groups coleção e não pode ser alterado. É útil principalmente na depuração para garantir que todos os itens foram adicionados corretamente a grupos.

ObservaçãoObservação

ListView grupos estão disponíveis somente no Windows XP e na família Windows Server 2003 (Windows XP Home Edition, Windows XP Professional, Windows Server 2003). Para obter mais informações, consulte o ListViewGroup tópico de visão geral.

O exemplo de código a seguir demonstra como o Group propriedade pode ser usada em um aplicativo que organiza ListView itens por valor subitem no modo de exibição de detalhes. Essa forma de agrupamento é semelhante ao agrupamento usado no Windows Explorer. No exemplo, os grupos são criados dinamicamente. Para cada coluna subitem, um grupo é criado para cada valor exclusivo subitem. Para a coluna do item pai, um grupo é criado para cada exclusiva letra inicial. Os grupos criados para cada coluna são armazenados em uma tabela de hash juntamente com o texto de subitem ou a letra inicial. Quando um cabeçalho de coluna for clicado, a tabela de hash correspondente a essa coluna é recuperada. Em seguida, os valores de texto subitem para aquela coluna são usados como chaves de tabela de hash para recuperar o grupo correto para cada item. O item é então atribuído ao grupo usando o Group propriedade.

Este exemplo de código é parte de um exemplo maior fornecido para a ListView.Groups propriedade.


// Sets myListView to the groups created for the specified column.
private void SetGroups(int column)
{
    // Remove the current groups.
    myListView.Groups.Clear();

    // Retrieve the hash table corresponding to the column.
    Hashtable groups = (Hashtable)groupTables[column];

    // Copy the groups for the column to an array.
    ListViewGroup[] groupsArray = new ListViewGroup[groups.Count];
    groups.Values.CopyTo(groupsArray, 0);

    // Sort the groups and add them to myListView.
    Array.Sort(groupsArray, new ListViewGroupSorter(myListView.Sorting));
    myListView.Groups.AddRange(groupsArray);

    // Iterate through the items in myListView, assigning each 
    // one to the appropriate group.
    foreach (ListViewItem item in myListView.Items)
    {
        // Retrieve the subitem text corresponding to the column.
        string subItemText = item.SubItems[column].Text;

        // For the Title column, use only the first letter.
        if (column == 0) 
        {
            subItemText = subItemText.Substring(0, 1);
        }

        // Assign the item to the matching group.
        item.Group = (ListViewGroup)groups[subItemText];
    }
}


.NET Framework

Com suporte em: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Com suporte em: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Função Server Core sem suporte), Windows Server 2008 R2 (Função Server Core com suporte com o SP1 ou posterior, Itanium sem suporte)

O .NET Framework não oferece suporte a todas as versões de cada plataforma. Para obter uma lista das versões com suporte, consulte Requisitos do sistema do .NET Framework.

Contribuições da comunidade

ADICIONAR
A Microsoft está realizando uma pesquisa online para saber sua opinião sobre o site do MSDN. Se você optar por participar, a pesquisa online lhe será apresentada quando você sair do site do MSDN.

Deseja participar?
Mostrar:
© 2014 Microsoft