ListViewGroupCollection.Clear Метод

Определение

Удаляет все группы из коллекции.Removes all groups from the collection.

public:
 virtual void Clear();
public void Clear ();
abstract member Clear : unit -> unit
override this.Clear : unit -> unit
Public Sub Clear ()

Реализации

Примеры

В следующем примере показано, как Clear метод можно использовать в приложении, которое организует ListView элементы по значению подэлемента в представлении Details.The following example demonstrates how the Clear method can be used in an application that organizes ListView items by subitem value in the details view. Такая форма группирования похожа на группирование, используемое в проводнике Windows.This form of grouping is similar to the grouping used in Windows Explorer. В этом примере группы создаются динамически.In the example, the groups are created dynamically. Для каждого столбца подэлементов создается одна группа для каждого уникального значения подэлемента.For each subitem column, one group is created for each unique subitem value. Для столбца родительского элемента для каждой уникальной исходной буквы создается одна группа.For the parent item column, one group is created for each unique initial letter. Группы, созданные для каждого столбца, хранятся в хэш-таблице вместе с текстом подэлемента или начальной буквой.The groups created for each column are stored in a hash table along with the subitem text or initial letter. При нажатии на заголовок столбца удаляется ListViewGroupCollection .When a column header is clicked, the ListViewGroupCollection is cleared. Затем возвращается хэш-таблица, соответствующая выбранному столбцу, и каждый элемент назначается соответствующей группе.The hash table corresponding to the clicked column is then retrieved and each item is assigned to the appropriate group. Наконец, упорядоченный массив групп в хэш-таблице добавляется в ListViewGroupCollection .Finally, a sorted array of the groups in the hash table is added to the ListViewGroupCollection.

Полный пример см ListViewGroupCollection . в справочном разделе Обзор.For the complete example, see the ListViewGroupCollection overview reference topic.

   // 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

Комментарии

Этот метод используется для удаления всех групп из коллекции.Use this method to remove all the groups from the collection. Обратите внимание, что удаление групп из ListView.Groups коллекции не приводит к удалению элементов из этого ListView элемента управления.Note that removing groups from the ListView.Groups collection does not remove items from the ListView control.

Этот метод полезен для отключения функции группирования.This method is useful to disable the grouping feature. Если в ListView элементе управления нет групп, элементы отображаются обычным образом.When there are no groups in a ListView control, the items appear normally. Чтобы удалить отдельные группы из коллекции, используйте Remove RemoveAt метод или.To remove individual groups from the collection, use the Remove or RemoveAt method.

Этот метод также полезен, если требуется предоставить несколько способов группирования элементов.This method is also useful when you want to provide multiple ways to group the items. Чтобы изменить группирование, сначала используйте Clear метод, чтобы удалить все группы из коллекции, а затем используйте метод, AddRange чтобы добавить другой массив групп.To change the grouping, first use the Clear method to remove all the groups from the collection, then use the AddRange method to add a different array of groups.

Применяется к