ListViewItem.Group Propriedade

Definição

Obtém ou define o grupo ao qual o item está atribuído.Gets or sets the group to which the item is assigned.

public:
 property System::Windows::Forms::ListViewGroup ^ Group { System::Windows::Forms::ListViewGroup ^ get(); void set(System::Windows::Forms::ListViewGroup ^ value); };
public System.Windows.Forms.ListViewGroup Group { get; set; }
member this.Group : System.Windows.Forms.ListViewGroup with get, set
Public Property Group As ListViewGroup

Valor da propriedade

O ListViewGroup ao qual o item está atribuído.The ListViewGroup to which the item is assigned.

Exemplos

O exemplo de código a seguir demonstra como a propriedade Group pode ser usada em um aplicativo que organiza ListView itens por valor de subitem no modo de exibição de detalhes.The following code example demonstrates how the Group property can be used in an application that organizes ListView items by subitem value in the details view. Essa forma de agrupamento é semelhante ao agrupamento usado no Windows Explorer.This form of grouping is similar to the grouping used in Windows Explorer. No exemplo, os grupos são criados dinamicamente.In the example, the groups are created dynamically. Para cada coluna de subitem, um grupo é criado para cada valor de subitem exclusivo.For each subitem column, one group is created for each unique subitem value. Para a coluna item pai, um grupo é criado para cada letra inicial exclusiva.For the parent item column, one group is created for each unique initial letter. Os grupos criados para cada coluna são armazenados em uma tabela de hash juntamente com o texto do subitem ou a letra inicial.The groups created for each column are stored in a hash table along with the subitem text or initial letter. Quando um cabeçalho de coluna é clicado, a tabela de hash correspondente a essa coluna é recuperada.When a column header is clicked, the hash table corresponding to that column is retrieved. Em seguida, os valores de texto do subitem para essa coluna são usados como chaves de tabela de hash para recuperar o grupo correto para cada item.Next, the subitem text values for that column are used as hash table keys to retrieve the correct group for each item. O item é então atribuído ao grupo usando a propriedade Group.The item is then assigned to the group using the Group property.

Este exemplo de código faz parte de um exemplo maior fornecido para a propriedade ListView.Groups.This code example is part of a larger example provided for the ListView.Groups property.

   // 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 = dynamic_cast<Hashtable^>(groupTables[column]);

      // Copy the groups for the column to an array.
      array<ListViewGroup^>^ groupsArray = gcnew array<ListViewGroup^>(groups->Count);
      groups->Values->CopyTo(groupsArray, 0);

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

      // Iterate through the items in myListView, assigning each 
      // one to the appropriate group.
      IEnumerator^ myEnum = myListView->Items->GetEnumerator();
      while (myEnum->MoveNext())
      {
         ListViewItem^ item = safe_cast<ListViewItem^>(myEnum->Current);
         // 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 = dynamic_cast<ListViewGroup^>(groups[subItemText]);
      }
   }
// 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];
    }
}
' Sets myListView to the groups created for the specified column.
Private Sub SetGroups(column As Integer)
    ' Remove the current groups.
    myListView.Groups.Clear()
    
    ' Retrieve the hash table corresponding to the column.
    Dim groups As Hashtable = CType(groupTables(column), Hashtable)
    
    ' Copy the groups for the column to an array.
    Dim groupsArray(groups.Count - 1) As ListViewGroup
    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.
    Dim item As ListViewItem
    For Each item In myListView.Items
        ' Retrieve the subitem text corresponding to the column.
        Dim subItemText As String = item.SubItems(column).Text
        
        ' For the Title column, use only the first letter.
        If column = 0 Then
            subItemText = subItemText.Substring(0, 1)
        End If 

        ' Assign the item to the matching group.
        item.Group = CType(groups(subItemText), ListViewGroup)
    Next item
End Sub

Comentários

Use essa propriedade para definir o grupo ao qual um item pertence.Use this property to set the group to which an item belongs. Você também pode definir o grupo no construtor de ListViewItem ou pode usar essa propriedade para modificar a associação de grupo em tempo de execução.You can also set the group in the ListViewItem constructor, or you can use this property to modify the group membership at run time. Se você definir essa propriedade como null e houver grupos na coleção de ListView.Groups, o item será exibido no grupo padrão, que tem o rótulo de cabeçalho "DefaultGroupSystem. Windows. Forms".If you set this property to null and there are groups in the ListView.Groups collection, the item will appear in the default group, which has the header label "DefaultGroupSystem.Windows.Forms". O grupo padrão não está contido na coleção de ListView.Groups e não pode ser alterado.The default group is not contained in the ListView.Groups collection, and cannot be altered. Ele é útil principalmente na depuração para garantir que todos os itens tenham sido corretamente adicionados aos grupos.It is primarily useful in debugging to ensure that all items have been properly added to groups.

Observação

ListView grupos só estão disponíveis no Windows XP e na família Windows Server 2003 (Windows XP Home Edition, Windows XP Professional, Windows Server 2003Windows XP Home Edition, Windows XP Professional, Windows Server 2003).ListView groups are only available on Windows XP and the Windows Server 2003 family (Windows XP Home Edition, Windows XP Professional, Windows Server 2003Windows XP Home Edition, Windows XP Professional, Windows Server 2003). Para obter mais informações, consulte o tópico de visão geral ListViewGroup.For more information, see the ListViewGroup overview topic.

Aplica-se a

Veja também