ListView.ListViewItemCollection Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

ListView.ListViewItemCollection.cs

Představuje kolekci položek v ovládacím ListView prvku nebo přiřazených k objektu ListViewGroup.

public: ref class ListView::ListViewItemCollection : System::Collections::IList

[System.ComponentModel.ListBindable(false)]
public class ListView.ListViewItemCollection : System.Collections.IList

[<System.ComponentModel.ListBindable(false)>]
type ListView.ListViewItemCollection = class
    interface IList
    interface ICollection
    interface IEnumerable

Public Class ListView.ListViewItemCollection
Implements IList

Dědičnost

Object

ListView.ListViewItemCollection

Atributy

ListBindableAttribute

Implementuje

ICollection IEnumerable IList

Příklady

Následující příklad kódu ukazuje, jak přidat položky do .ListView.ListViewItemCollection Všimněte si, že Items vlastnost ListView1 je typu ListView.ListViewItemCollection. Chcete-li spustit tento příklad, vložte následující kód do formuláře, který obsahuje objekt pojmenovaný ListViewListView1 a pojmenovaný TextBoxTextBox1. InitializeListView Volání metody z konstruktoru formuláře nebo Load obslužné rutiny události.

// This method adds two columns to the ListView, setting the Text 
// and TextAlign, and Width properties of each ColumnHeader.  The 
// HeaderStyle property is set to NonClickable since the ColumnClick 
// event is not handled.  Finally the method adds ListViewItems and 
// SubItems to each column.
void InitializeListView()
{
   this->ListView1 = gcnew System::Windows::Forms::ListView;
   this->ListView1->BackColor = System::Drawing::SystemColors::Control;
   this->ListView1->Dock = System::Windows::Forms::DockStyle::Top;
   this->ListView1->Location = System::Drawing::Point( 0, 0 );
   this->ListView1->Name = "ListView1";
   this->ListView1->Size = System::Drawing::Size( 292, 130 );
   this->ListView1->TabIndex = 0;
   this->ListView1->View = System::Windows::Forms::View::Details;
   this->ListView1->MultiSelect = true;
   this->ListView1->HideSelection = false;
   this->ListView1->HeaderStyle = ColumnHeaderStyle::Nonclickable;
   ColumnHeader^ columnHeader1 = gcnew ColumnHeader;
   columnHeader1->Text = "Breakfast Item";
   columnHeader1->TextAlign = HorizontalAlignment::Left;
   columnHeader1->Width = 146;
   ColumnHeader^ columnHeader2 = gcnew ColumnHeader;
   columnHeader2->Text = "Price Each";
   columnHeader2->TextAlign = HorizontalAlignment::Center;
   columnHeader2->Width = 142;
   this->ListView1->Columns->Add( columnHeader1 );
   this->ListView1->Columns->Add( columnHeader2 );
   array<String^>^foodList = {"Juice","Coffee","Cereal & Milk","Fruit Plate","Toast & Jelly","Bagel & Cream Cheese"};
   array<String^>^foodPrice = {"1.09","1.09","2.19","2.49","1.49","1.49"};
   for ( int count = 0; count < foodList->Length; count++ )
   {
      ListViewItem^ listItem = gcnew ListViewItem( foodList[ count ] );
      listItem->SubItems->Add( foodPrice[ count ] );
      ListView1->Items->Add( listItem );

   }
   this->Controls->Add( ListView1 );
}

  // This method adds two columns to the ListView, setting the Text 
  // and TextAlign, and Width properties of each ColumnHeader.  The 
  // HeaderStyle property is set to NonClickable since the ColumnClick 
  // event is not handled.  Finally the method adds ListViewItems and 
  // SubItems to each column.
  private void InitializeListView()
  {
      this.ListView1 = new System.Windows.Forms.ListView();
      this.ListView1.BackColor = System.Drawing.SystemColors.Control;
      this.ListView1.Dock = System.Windows.Forms.DockStyle.Top;
      this.ListView1.Location = new System.Drawing.Point(0, 0);
      this.ListView1.Name = "ListView1";
      this.ListView1.Size = new System.Drawing.Size(292, 130);
      this.ListView1.TabIndex = 0;
      this.ListView1.View = System.Windows.Forms.View.Details;
      this.ListView1.MultiSelect = true;
      this.ListView1.HideSelection = false;
      this.ListView1.HeaderStyle = ColumnHeaderStyle.Nonclickable;
      
      ColumnHeader columnHeader1 = new ColumnHeader();
      columnHeader1.Text = "Breakfast Item";
      columnHeader1.TextAlign = HorizontalAlignment.Left;
      columnHeader1.Width = 146;

      ColumnHeader columnHeader2 = new ColumnHeader();
      columnHeader2.Text = "Price Each";
      columnHeader2.TextAlign = HorizontalAlignment.Center;
      columnHeader2.Width = 142;

      this.ListView1.Columns.Add(columnHeader1);
      this.ListView1.Columns.Add(columnHeader2);

      string[] foodList = new string[]{"Juice", "Coffee", 
          "Cereal & Milk", "Fruit Plate", "Toast & Jelly", 
          "Bagel & Cream Cheese"};
      string[] foodPrice = new string[]{"1.09", "1.09", "2.19", 
          "2.49", "1.49", "1.49"};
      
      for(int count=0; count < foodList.Length; count++)
      {
          ListViewItem listItem = new ListViewItem(foodList[count]);
          listItem.SubItems.Add(foodPrice[count]);
          ListView1.Items.Add(listItem);
      }
      this.Controls.Add(ListView1);
  }

' This method adds two columns to the ListView, setting the Text 
' and TextAlign, and Width properties of each ColumnHeader.  The 
' HeaderStyle property is set to NonClickable since the ColumnClick 
' event is not handled.  Finally the method adds ListViewItems and 
' SubItems to each column.
Private Sub InitializeListView()
    Me.ListView1 = New System.Windows.Forms.ListView
    Me.ListView1.BackColor = System.Drawing.SystemColors.Control
    Me.ListView1.Dock = System.Windows.Forms.DockStyle.Top
    Me.ListView1.Location = New System.Drawing.Point(0, 0)
    Me.ListView1.Name = "ListView1"
    Me.ListView1.Size = New System.Drawing.Size(292, 130)
    Me.ListView1.TabIndex = 0
    Me.ListView1.View = System.Windows.Forms.View.Details
    Me.ListView1.MultiSelect = True
    Me.ListView1.HideSelection = False
    ListView1.HeaderStyle = ColumnHeaderStyle.Nonclickable
    Dim columnHeader1 As New ColumnHeader
    With columnHeader1
        .Text = "Breakfast Item"
        .TextAlign = HorizontalAlignment.Left
        .Width = 146
    End With
    Dim columnHeader2 As New ColumnHeader
    With columnHeader2
        .Text = "Price Each"
        .TextAlign = HorizontalAlignment.Center
        .Width = 142
    End With

    Me.ListView1.Columns.Add(columnHeader1)
    Me.ListView1.Columns.Add(columnHeader2)
    Dim foodList() As String = New String() {"Juice", "Coffee", _
        "Cereal & Milk", "Fruit Plate", "Toast & Jelly", _
        "Bagel & Cream Cheese"}
    Dim foodPrice() As String = New String() {"1.09", "1.09", _
        "2.19", "2.49", "1.49", "1.49"}
    Dim count As Integer
    For count = 0 To foodList.Length - 1
        Dim listItem As New ListViewItem(foodList(count))
        listItem.SubItems.Add(foodPrice(count))
        ListView1.Items.Add(listItem)
    Next
    Me.Controls.Add(Me.ListView1)
End Sub

Poznámky

A ListView.ListViewItemCollection ukládá položky zobrazené v ovládacím ListView prvku nebo přiřazené ListViewGroupk . V rámci ListView třídy jsou definovány dvě další kolekce, které umožňují určit, které položky jsou vybrány v ListView rámci ovládacího prvku. Třída ListView.SelectedListViewItemCollection poskytuje vlastnosti a metody pro určení položek, které jsou vybrány v ovládacím ListView prvku, zatímco ListView.SelectedIndexCollection třída umožňuje určit, jaké indexy v rámci ListView.ListViewItemCollectionListView ovládacího prvku jsou vybrány. Kromě tříd kolekce výběru existují také dvě třídy, které umožňují určit, které položky jsou zaškrtnuté (když CheckBoxes je vlastnost ListView ovládacího prvku nastavena na true) v této kolekci.

Existuje několik způsobů, jak do kolekce přidat položky. Metoda Add přidá do kolekce jednu položku. Pokud chcete do kolekce přidat několik položek, vytvoříte pole položek a předáte ho metodě AddRange . Pokud chcete vložit položku do konkrétního umístění v kolekci, můžete použít metodu Insert . Pokud chcete položky odebrat, můžete použít metodu Remove nebo metodu RemoveAt , pokud víte, kde se položka nachází v kolekci. Tato Clear metoda umožňuje odebrat všechny položky z kolekce namísto použití Remove metody k odebrání jedné položky najednou.

Kromě metod a vlastností pro přidávání a odebírání položek ListView.ListViewItemCollection poskytuje také metody pro vyhledání položek v kolekci. Tato Contains metoda umožňuje určit, zda je položka členem kolekce. Jakmile víte, že položka je umístěna v kolekci, můžete pomocí IndexOf metody určit, kde se položka nachází v kolekci.

Konstruktory

Name	Description
ListView.ListViewItemCollection(ListView)	Inicializuje novou instanci ListView.ListViewItemCollection třídy.

Vlastnosti

Name	Description
Count	Získá počet položek v kolekci.
IsReadOnly	Získá hodnotu určující, zda kolekce je jen pro čtení.
Item[Int32]	Získá nebo nastaví položku v zadaném indexu v kolekci.
Item[String]	Načte položku se zadaným klíčem.

Metody

Name	Description
Add(ListViewItem)	Přidá existující ListViewItem kolekci.
Add(String, Int32)	Vytvoří položku se zadaným textem a obrázkem a přidá ji do kolekce.
Add(String, String, Int32)	Vytvoří položku se zadaným klíčem, textem a obrázkem a přidá položku do kolekce.
Add(String, String, String)	Vytvoří položku se zadaným klíčem, textem a obrázkem a přidá ji do kolekce.
Add(String, String)	Vytvoří položku se zadaným textem a obrázkem a přidá ji do kolekce.
Add(String)	Vytvoří položku se zadaným textem a přidá ji do kolekce.
AddRange(ListView+ListViewItemCollection)	Přidá kolekci položek do kolekce.
AddRange(ListViewItem[])	Přidá do kolekce pole ListViewItem objektů.
Clear()	Odebere všechny položky z kolekce.
Contains(ListViewItem)	Určuje, zda je zadaná položka umístěna v kolekci.
ContainsKey(String)	Určuje, zda kolekce obsahuje položku se zadaným klíčem.
CopyTo(Array, Int32)	Zkopíruje celou kolekci do existujícího pole v zadaném umístění v rámci pole.
Find(String, Boolean)	Vyhledá položky, jejichž název odpovídá zadanému klíči, volitelně vyhledá dílčí položky.
GetEnumerator()	Vrátí enumerátor, který se použije k iteraci v kolekci položek.
IndexOf(ListViewItem)	Vrátí index v kolekci zadané položky.
IndexOfKey(String)	Načte index položky se zadaným klíčem.
Insert(Int32, ListViewItem)	Vloží do kolekce existující ListViewItem v zadaném indexu.
Insert(Int32, String, Int32)	Vytvoří novou položku se zadaným indexem image a vloží ji do kolekce v zadaném indexu.
Insert(Int32, String, String, Int32)	Vytvoří novou položku se zadaným klíčem, textem a obrázkem a vloží ji do kolekce v zadaném indexu.
Insert(Int32, String, String, String)	Vytvoří novou položku se zadaným klíčem, textem a obrázkem a přidá ji do kolekce v zadaném indexu.
Insert(Int32, String, String)	Vytvoří novou položku se zadaným textem a obrázkem a vloží ji do kolekce v zadaném indexu.
Insert(Int32, String)	Vytvoří novou položku a vloží ji do kolekce v zadaném indexu.
Remove(ListViewItem)	Odebere zadanou položku z kolekce.
RemoveAt(Int32)	Odebere položku v zadaném indexu v kolekci.
RemoveByKey(String)	Odebere položku se zadaným klíčem z kolekce.

Explicitní implementace rozhraní

Name	Description
ICollection.IsSynchronized	Získá hodnotu označující, zda je přístup ke kolekci synchronizován (bezpečné vlákno).
ICollection.SyncRoot	Získá objekt, který lze použít k synchronizaci přístupu k kolekci ovládacích prvků.
IList.Add(Object)	Přidá existující objekt do kolekce.
IList.Contains(Object)	Určuje, zda je zadaná položka v kolekci.
IList.IndexOf(Object)	Vrátí index v kolekci zadané položky.
IList.Insert(Int32, Object)	Vloží objekt do kolekce v zadaném indexu.
IList.IsFixedSize	Získá hodnotu určující, zda kolekce má pevnou velikost.
IList.Item[Int32]	Získá nebo nastaví v zadaném ListViewItem indexu v kolekci.
IList.Remove(Object)	Odebere zadanou položku z kolekce.

Viz také

• ListView.SelectedListViewItemCollection
• ListView.SelectedIndexCollection