ListViewGroupCollection.AddRange ListViewGroupCollection.AddRange ListViewGroupCollection.AddRange ListViewGroupCollection.AddRange Method

Definition

Fügt der Auflistung mehrere Gruppen hinzu.Adds multiple groups to the collection.

Überlädt

AddRange(ListViewGroup[]) AddRange(ListViewGroup[]) AddRange(ListViewGroup[]) AddRange(ListViewGroup[])

Fügt der Auflistung ein Array von Gruppen hinzu.Adds an array of groups to the collection.

AddRange(ListViewGroupCollection) AddRange(ListViewGroupCollection) AddRange(ListViewGroupCollection) AddRange(ListViewGroupCollection)

Fügt der Auflistung die Gruppen in einer vorhandenen ListViewGroupCollection hinzu.Adds the groups in an existing ListViewGroupCollection to the collection.

AddRange(ListViewGroup[]) AddRange(ListViewGroup[]) AddRange(ListViewGroup[]) AddRange(ListViewGroup[])

Fügt der Auflistung ein Array von Gruppen hinzu.Adds an array of groups to the collection.

public:
 void AddRange(cli::array <System::Windows::Forms::ListViewGroup ^> ^ groups);
public void AddRange (System.Windows.Forms.ListViewGroup[] groups);
member this.AddRange : System.Windows.Forms.ListViewGroup[] -> unit
Public Sub AddRange (groups As ListViewGroup())

Parameter

groups
ListViewGroup[]

Ein Array vom Typ ListViewGroup, das die Gruppen angibt, die der Auflistung hinzugefügt werden sollen.An array of type ListViewGroup that specifies the groups to add to the collection.

Ausnahmen

groups enthält mindestens eine Gruppe mit mindestens einem ListViewItem, das zu einem ListView-Steuerelement gehört, das nicht das Steuerelement ist, das diese ListViewGroupCollection besitzt.groups contains at least one group with at least one ListViewItem that belongs to a ListView control other than the one that owns this ListViewGroupCollection.

Beispiele

Im folgenden Beispiel wird veranschaulicht, AddRange wie die-Methode in einer Anwendung verwendet werden ListView kann, die Elemente nach Unterelement-Wert in der Detailansicht organisiert.The following example demonstrates how the AddRange method can be used in an application that organizes ListView items by subitem value in the details view. Diese Form der Gruppierung ähnelt der im Windows-Explorer verwendeten Gruppierung.This form of grouping is similar to the grouping used in Windows Explorer. Im Beispiel werden die Gruppen dynamisch erstellt.In the example, the groups are created dynamically. Für jede Unterelement Spalte wird eine Gruppe für jeden eindeutigen Unterelement Wert erstellt.For each subitem column, one group is created for each unique subitem value. Für die übergeordnete Element Spalte wird eine Gruppe für jeden eindeutigen Anfangsbuchstaben erstellt.For the parent item column, one group is created for each unique initial letter. Die für jede Spalte erstellten Gruppen werden zusammen mit dem untergeordneten Text oder dem ersten Buchstaben in einer Hash Tabelle gespeichert.The groups created for each column are stored in a hash table along with the subitem text or initial letter. Beim Klicken ListViewGroupCollection auf eine Spaltenüberschrift wird gelöscht.When a column header is clicked, the ListViewGroupCollection is cleared. Die Hash Tabelle, die der Spalte, auf die geklickt wurde, wird dann abgerufen, und jedes Element wird der entsprechenden Gruppe zugewiesen.The hash table corresponding to the clicked column is then retrieved and each item is assigned to the appropriate group. Schließlich wird ein sortiertes Array der Gruppen in der Hash Tabelle hinzugefügt ListViewGroupCollection.Finally, a sorted array of the groups in the hash table is added to the ListViewGroupCollection.

Das komplette Beispiel finden Sie im ListViewGroupCollection Übersichts Referenz Thema.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 'SetGroups

Hinweise

Verwenden Sie diese Version der AddRange -Methode, um ein Array von Gruppen zur Gruppen Auflistung hinzuzufügen.Use this version of the AddRange method to add an array of groups to the group collection. Diese Methode ist nützlich, wenn Sie mehrere ListViewGroup Objekte erstellen und Sie mit einem einzigen Methoden Aufrufder Auflistung hinzufügen möchten.This method is useful when you create multiple ListViewGroup objects and want to add them to the collection with a single method call. Verwenden Sie die Add -Methode, um der Auflistung einzelne Gruppen hinzuzufügen.To add individual groups to the collection, use the Add method.

Diese Methode ist auch nützlich, wenn Sie mehrere Möglichkeiten zum Gruppieren der Elemente in einem ListView -Steuerelement bereitstellen möchten.This method is also useful when you want to provide multiple ways to group the items in a ListView control. Erstellen Sie zu diesem Zweck mehrere Gruppen Arrays.To do this, create multiple group arrays. Um die Gruppierung zu ändern, verwenden Sie Clear zuerst die-Methode, um alle Gruppen aus der Auflistung zu entfernen AddRange , und verwenden Sie dann die-Methode, um ein anderes Array von Gruppen hinzuzufügen.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.

Anders als Add bei der- AddRange Methode verfügt die-Methode über keinen Rückgabewert, der verwendet werden kann, um zu bestimmen, ob eine hinzugefügte Gruppe bereits in der Auflistung vorhanden ist.Unlike the Add method, the AddRange method does not have a return value that can be used to determine whether a group being added is already in the collection. Wenn Sie diese Informationen benötigen, verwenden Sie Contains die-Methode, AddRange bevor Sie die-Methode verwenden.If you need this information, use the Contains method before using the AddRange method.

Siehe auch

AddRange(ListViewGroupCollection) AddRange(ListViewGroupCollection) AddRange(ListViewGroupCollection) AddRange(ListViewGroupCollection)

Fügt der Auflistung die Gruppen in einer vorhandenen ListViewGroupCollection hinzu.Adds the groups in an existing ListViewGroupCollection to the collection.

public:
 void AddRange(System::Windows::Forms::ListViewGroupCollection ^ groups);
public void AddRange (System.Windows.Forms.ListViewGroupCollection groups);
member this.AddRange : System.Windows.Forms.ListViewGroupCollection -> unit
Public Sub AddRange (groups As ListViewGroupCollection)

Parameter

groups
ListViewGroupCollection ListViewGroupCollection ListViewGroupCollection ListViewGroupCollection

Eine ListViewGroupCollection, die die Gruppen enthält, die der Auflistung hinzugefügt werden sollen.A ListViewGroupCollection containing the groups to add to the collection.

Ausnahmen

groups enthält mindestens eine Gruppe mit mindestens einem ListViewItem, das zu einem ListView-Steuerelement gehört, das nicht das Steuerelement ist, das diese ListViewGroupCollection besitzt.groups contains at least one group with at least one ListViewItem that belongs to a ListView control other than the one that owns this ListViewGroupCollection.

Hinweise

Verwenden Sie diese Version der AddRange -Methode, um die Elemente ListViewGroupCollection eines hinzuzufügen, das Sie ListView.Groups über die-Eigenschaft ListView eines anderen Steuer Elements abrufen.Use this version of the AddRange method to add the elements of a ListViewGroupCollection that you retrieve through the ListView.Groups property of a different ListView control.

Anders als Add bei der- AddRange Methode verfügt die-Methode über keinen Rückgabewert, der verwendet werden kann, um zu bestimmen, ob eine hinzugefügte Gruppe bereits in der Auflistung vorhanden ist.Unlike the Add method, the AddRange method does not have a return value that can be used to determine whether a group being added is already in the collection. Wenn Sie diese Informationen benötigen, verwenden Sie Contains die-Methode, AddRange bevor Sie die-Methode verwenden.If you need this information, use the Contains method before using the AddRange method.

Gilt für: