ListViewGroupCollection.AddRange Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Aggiunge più gruppi all'insieme.

Overload

AddRange(ListViewGroup[])	Aggiunge una matrice di gruppi all'insieme.
AddRange(ListViewGroupCollection)	Aggiunge i gruppi di un oggetto ListViewGroupCollection esistente all'insieme.

AddRange(ListViewGroup[])

Aggiunge una matrice di gruppi all'insieme.

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())

Parametri

groups

ListViewGroup[]

Matrice di tipo ListViewGroup che specifica i gruppi da aggiungere all'insieme.

Eccezioni

ArgumentException

groups contiene almeno un oggetto ListViewItem appartenente a un controllo ListView diverso da quello a cui appartiene questo ListViewGroupCollection.

InvalidOperationException

L'assegnazione ListView di questa raccolta è in modalità virtuale.

Esempio

Nell'esempio seguente viene illustrato come usare il AddRange metodo in un'applicazione che organizza ListView gli elementi in base al valore dell'elemento secondario nella visualizzazione dettagli. Questa forma di raggruppamento è simile al raggruppamento usato in Esplora risorse. Nell'esempio i gruppi vengono creati dinamicamente. Per ogni colonna dell'elemento secondario viene creato un gruppo per ogni valore univoco dell'elemento secondario. Per la colonna elemento padre, viene creato un gruppo per ogni lettera iniziale univoca. I gruppi creati per ogni colonna vengono archiviati in una tabella hash insieme al testo dell'elemento secondario o alla lettera iniziale. Quando si fa clic su un'intestazione di colonna, l'oggetto ListViewGroupCollection viene cancellato. La tabella hash corrispondente alla colonna selezionata viene quindi recuperata e ogni elemento viene assegnato al gruppo appropriato. Infine, viene aggiunta una matrice ordinata dei gruppi nella tabella hash all'oggetto ListViewGroupCollection.

Per l'esempio completo, vedere l'argomento ListViewGroupCollection di riferimento di panoramica.

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

Commenti

Utilizzare questa versione del AddRange metodo per aggiungere una matrice di gruppi alla raccolta di gruppi. Questo metodo è utile quando si creano più ListViewGroup oggetti e si desidera aggiungerli alla raccolta con una singola chiamata al metodo. Per aggiungere singoli gruppi alla raccolta, usare il Add metodo .

Questo metodo è utile anche quando si desidera fornire più modi per raggruppare gli elementi in un ListView controllo. A tale scopo, creare più matrici di gruppi. Per modificare il raggruppamento, usare innanzitutto il metodo per rimuovere tutti i gruppi dalla raccolta, quindi usare il ClearAddRange metodo per aggiungere una matrice diversa di gruppi.

A differenza del metodo, il AddAddRange metodo non ha un valore restituito che può essere usato per determinare se un gruppo aggiunto è già nella raccolta. Se sono necessarie queste informazioni, usare il metodo prima di usare il ContainsAddRange metodo .

Vedi anche

• ListViewGroup

AddRange(ListViewGroupCollection)

Aggiunge i gruppi di un oggetto ListViewGroupCollection esistente all'insieme.

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)

Parametri

groups

ListViewGroupCollection

Oggetto ListViewGroupCollection contenente i gruppi da aggiungere all'insieme.

Eccezioni

ArgumentException

groups contiene almeno un oggetto ListViewItem appartenente a un controllo ListView diverso da quello a cui appartiene questo ListViewGroupCollection.

InvalidOperationException

L'assegnazione ListView di questa raccolta è in modalità virtuale.

Commenti

Utilizzare questa versione del AddRange metodo per aggiungere gli elementi di un oggetto ListViewGroupCollection recuperato tramite la ListView.Groups proprietà di un controllo diverso ListView .

A differenza del metodo, il AddAddRange metodo non ha un valore restituito che può essere usato per determinare se un gruppo aggiunto è già nella raccolta. Se sono necessarie queste informazioni, usare il metodo prima di usare il ContainsAddRange metodo .