ListView.ListViewItemCollection Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

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 Items , že vlastnost je ListView1 typu ListView.ListViewItemCollection. Chcete-li spustit tento příklad, vložte následující kód do formuláře, který obsahuje ListView objekt s názvem a TextBox s názvem ListView1TextBox1. Volejte metodu InitializeListView 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

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

Existuje několik způsobů, jak přidat položky do kolekce. Metoda Add přidá do kolekce jednu položku. Pokud chcete do kolekce přidat určitý počet položek, vytvořte pole položek a předejte ho AddRange metodě . Pokud chcete vložit položku na určité místo 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 v kolekci nachází. Metoda Clear 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 hledání položek v kolekci. Metoda Contains umožňuje určit, zda je položka členem kolekce. Jakmile víte, že se položka nachází v kolekci, můžete pomocí IndexOf metody určit, kde se položka v kolekci nachází.

Konstruktory

ListView.ListViewItemCollection(ListView)

Inicializuje novou instanci ListView.ListViewItemCollection třídy .

Vlastnosti

Count	Získá počet prvků v kolekci.
IsReadOnly	Získá hodnotu, která udává, zda je kolekce určena jen pro čtení.
Item[Int32]	Získá nebo nastaví položku v zadaném indexu v rámci kolekce.
Item[String]	Načte položku se zadaným klíčem.

Metody

Add(ListViewItem)	Přidá existující ListViewItem do kolekce.
Add(String)	Vytvoří položku se zadaným textem a přidá ji do kolekce.
Add(String, Int32)	Vytvoří položku se zadaným 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, 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.
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.
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
Find(String, Boolean)	Vyhledá položky, jejichž název odpovídá zadanému klíči, a volitelně vyhledá podřízené položky.
GetEnumerator()	Vrátí enumerátor, který se použije k iteraci kolekcí položek.
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
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ží existující ListViewItem do kolekce v zadaném indexu.
Insert(Int32, String)	Vytvoří novou položku a vloží ji do kolekce v zadaném indexu.
Insert(Int32, String, Int32)	Vytvoří novou položku se zadaným indexem obrázku a vloží 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, 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.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
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.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Explicitní implementace rozhraní

ICollection.IsSynchronized	Získá hodnotu označující, zda přístup ke kolekci je synchronizován (bezpečné z více vláken).
ICollection.SyncRoot	Získá objekt, který lze použít k synchronizaci přístupu ke 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 označující, zda kolekce má pevnou velikost.
IList.Item[Int32]	Získá nebo nastaví v ListViewItem zadaném indexu v rámci kolekce.
IList.Remove(Object)	Odebere zadanou položku z kolekce.

Metody rozšíření

Viz také

• ListView.SelectedListViewItemCollection
• ListView.SelectedIndexCollection