ListViewGroupCollection.AddRange Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Přidá do kolekce více skupin.

Přetížení

AddRange(ListViewGroup[])	Přidá do kolekce pole skupin.
AddRange(ListViewGroupCollection)	Přidá existující skupiny ListViewGroupCollection do kolekce.

AddRange(ListViewGroup[])

Přidá do kolekce pole skupin.

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

Parametry

groups

ListViewGroup[]

Pole typu ListViewGroup , které určuje skupiny, které se mají přidat do kolekce.

Výjimky

ArgumentException

groups obsahuje alespoň jednu skupinu s alespoň jednou ListViewItem , která patří do jiného ListView ovládacího prvku než ten, který vlastní tento ListViewGroupCollection.

InvalidOperationException

Objekt ListView , ke kterému je tato kolekce přiřazená, je ve virtuálním režimu.

Příklady

Následující příklad ukazuje, jak lze použít metodu AddRange v aplikaci, která uspořádá ListView položky podle hodnoty podřízené položky v zobrazení podrobností. Tato forma seskupení je podobná seskupení používanému v Průzkumníku Windows. V tomto příkladu se skupiny vytvářejí dynamicky. Pro každý sloupec podřízené položky se vytvoří jedna skupina pro každou jedinečnou hodnotu podřízené položky. Pro sloupec nadřazené položky se vytvoří jedna skupina pro každé jedinečné počáteční písmeno. Skupiny vytvořené pro každý sloupec jsou uloženy v tabulce hash spolu s textem podřízené položky nebo počátečním písmenem. Když kliknete na záhlaví sloupce, hodnota se vymaže ListViewGroupCollection . Potom se načte zatřiďovací tabulka odpovídající sloupci, na který jste klikli, a každá položka se přiřadí příslušné skupině. Nakonec se do tabulky přidá seřazené pole skupin v tabulce ListViewGroupCollectionhash.

Úplný příklad najdete v tématu s referenčními informacemi k přehledu ListViewGroupCollection .

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

Poznámky

Tuto verzi AddRange metody použijte k přidání pole skupin do kolekce skupin. Tato metoda je užitečná, když vytváříte více ListViewGroup objektů a chcete je přidat do kolekce jedním voláním metody. Pokud chcete do kolekce přidat jednotlivé skupiny, použijte metodu Add .

Tato metoda je také užitečná, pokud chcete poskytnout více způsobů seskupení položek v ovládacím ListView prvku. Chcete-li to provést, vytvořte pole více skupin. Pokud chcete změnit seskupení, nejprve pomocí Clear metody odeberte všechny skupiny z kolekce a pak pomocí AddRange metody přidejte jiné pole skupin.

Add Na rozdíl od metody nemá metoda návratovou hodnotu, AddRange kterou lze použít k určení, zda je přidaná skupina již v kolekci. Pokud tyto informace potřebujete, před použitím metody použijte Contains metodu AddRange .

Viz také

• ListViewGroup

AddRange(ListViewGroupCollection)

Přidá existující skupiny ListViewGroupCollection do kolekce.

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)

Parametry

groups

ListViewGroupCollection

Obsahující ListViewGroupCollection skupiny, které se mají přidat do kolekce.

Výjimky

ArgumentException

groups obsahuje alespoň jednu skupinu s alespoň jednou ListViewItem , která patří do jiného ListView ovládacího prvku než ten, který vlastní tento ListViewGroupCollection.

InvalidOperationException

Objekt ListView , ke kterému je tato kolekce přiřazená, je ve virtuálním režimu.

Poznámky

Tuto verzi AddRange metody použijte k přidání prvků objektu ListViewGroupCollection , které načtete prostřednictvím ListView.Groups vlastnosti jiného ListView ovládacího prvku.

Add Na rozdíl od metody nemá metoda návratovou hodnotu, AddRange kterou lze použít k určení, zda je přidaná skupina již v kolekci. Pokud tyto informace potřebujete, před použitím metody použijte Contains metodu AddRange .