ListView.ListViewItemCollection.Add Metoda

  • Reference

Definice

Obor názvů:
System.Windows.Forms
Sestavení:
System.Windows.Forms.dll

Přidá položku do kolekce položek.

Přetížení

Add(String)

Vytvoří položku se zadaným textem a přidá ji do kolekce.
Add(ListViewItem)

Přidá existující ListViewItem 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.

Add(String)

Vytvoří položku se zadaným textem a přidá ji do kolekce.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text);
public virtual System.Windows.Forms.ListViewItem Add (string text);
public virtual System.Windows.Forms.ListViewItem Add (string? text);
abstract member Add : string -> System.Windows.Forms.ListViewItem
override this.Add : string -> System.Windows.Forms.ListViewItem
Public Overridable Function Add (text As String) As ListViewItem

Parametry

text
String

Text, který se má zobrazit pro položku.

Návraty

ListViewItem

Hodnota ListViewItem , která byla přidána do kolekce.

Poznámky

Tuto verzi Add metody můžete použít k vytvoření nového ListViewItem pro přidání do ListView ovládacího prvku. Text nového ListViewItem přidaného do ovládacího prvku je založený na parametru text . Pokud chcete pro položku zadat obrázek, použijte jako parametr verzi Add metody, která přijímá index obrázku. Pokud máte existující ListViewItem , který chcete přidat do kolekce, použijte verzi Add metody, která přijímá ListViewItem jako svůj parametr .

ListView.Sorting Pokud je vlastnost nastavena na jinou hodnotu než SortOrder.None nebo pokud ListViewItemSorter je vlastnost nastavena, seznam se seřadí po přidání položky. V opačném případě se položka vloží na konec seznamu. Pokud seznam není seřazený, můžete použít metodu Insert k vložení položky do objektu ListView na určité pozici. Pokud chcete přidat sadu položek do ovládacího prvku v jedné operaci, použijte metodu AddRange . Pokud chcete použít metodu Add pro přidání velkého počtu položek do ovládacího prvku, použijte BeginUpdate metody a EndUpdate , aby se zabránilo ListView překreslení, dokud nebudou přidány všechny položky. Při přidávání položek do ListViewje efektivnější položky nejprve seřadit a pak přidat nové položky.

Viz také

Platí pro

Add(ListViewItem)

Přidá existující ListViewItem do kolekce.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::Windows::Forms::ListViewItem ^ value);
public virtual System.Windows.Forms.ListViewItem Add (System.Windows.Forms.ListViewItem value);
abstract member Add : System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItem
override this.Add : System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItem
Public Overridable Function Add (value As ListViewItem) As ListViewItem

Parametry

value
ListViewItem

Přidá ListViewItem se do kolekce.

Návraty

ListViewItem

Hodnota ListViewItem , která byla přidána do kolekce.

Poznámky

Tuto verzi Add metody můžete použít k přidání existující ListViewItem do kolekce. Tato verze Add metody se obvykle používá k opakovanému použití položek z jiných ListView ovládacích prvků nebo pokud ListViewItem byl vytvořen ručně před přidáním do kolekce. Pokud chcete místo použití existující položky vytvořit novou ListViewItem položku, použijte jiné verze Add metody .

ListView.Sorting Pokud je vlastnost nastavena na jinou hodnotu než SortOrder.None nebo pokud ListViewItemSorter je vlastnost nastavena, seznam se seřadí po přidání položky. V opačném případě se položka vloží na konec seznamu. Pokud seznam není seřazený, můžete použít metodu Insert k vložení položky do objektu ListView na určité pozici. Pokud chcete přidat sadu položek do ovládacího prvku v jedné operaci, použijte metodu AddRange . Pokud chcete použít metodu Add pro přidání velkého počtu položek do ovládacího prvku, použijte BeginUpdate metody a EndUpdate , aby se zabránilo ListView překreslení, dokud nebudou přidány všechny položky. Při přidávání položek do ListViewje efektivnější položky nejprve seřadit a pak přidat nové položky.

Tato verze metody se Add také používá k přiřazení k ListViewItemListViewGroup.

Viz také

Platí pro

Add(String, Int32)

Vytvoří položku se zadaným textem a obrázkem a přidá ji do kolekce.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text, int imageIndex);
public virtual System.Windows.Forms.ListViewItem Add (string text, int imageIndex);
public virtual System.Windows.Forms.ListViewItem Add (string? text, int imageIndex);
abstract member Add : string * int -> System.Windows.Forms.ListViewItem
override this.Add : string * int -> System.Windows.Forms.ListViewItem
Public Overridable Function Add (text As String, imageIndex As Integer) As ListViewItem

Parametry

text
String

Text položky

imageIndex
Int32

Index obrázku, který se má zobrazit pro položku.

Návraty

ListViewItem

Hodnota ListViewItem , která byla přidána do kolekce.

Poznámky

Tuto verzi Add metody můžete použít k vytvoření nového ListViewItem , který přidáte do ListView ovládacího prvku. Text nového ListViewItem přidaného do ovládacího prvku je založený na parametru text . Můžete také určit obrázek položky předáním indexu přiřazeného ImageList vlastnosti ListView.LargeImageList a ListView.SmallImageList do parametru imageIndex . (Vlastnosti a ListView.SmallImageList obvykle ListView.LargeImageList používají stejné pozice indexu k zobrazení souvisejících obrázků.) Pokud nechcete zadat index obrázku pro položku, použijte verzi Add metody, která jako parametr přijímá pouze řetězec. Pokud máte existující ListViewItem , který chcete přidat do kolekce, použijte verzi Add metody, která přijímá ListViewItem jako svůj parametr .

ListView.Sorting Pokud je vlastnost nastavena na jinou hodnotu než SortOrder.None nebo pokud ListViewItemSorter je vlastnost nastavena, seznam se seřadí po přidání položky. V opačném případě se položka vloží na konec seznamu. Pokud seznam není seřazený, můžete použít metodu Insert k vložení položky do objektu ListView na určité pozici. Pokud chcete přidat sadu položek do ovládacího prvku v jedné operaci, použijte metodu AddRange . Pokud chcete použít metodu Add pro přidání velkého počtu položek do ovládacího prvku, použijte BeginUpdate metody a EndUpdate , aby se zabránilo ListView překreslení, dokud nebudou přidány všechny položky. Při přidávání položek do ListViewje efektivnější položky nejprve seřadit a pak přidat nové položky.

Viz také

Platí pro

Add(String, String)

Vytvoří položku se zadaným textem a obrázkem a přidá ji do kolekce.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text, System::String ^ imageKey);
public virtual System.Windows.Forms.ListViewItem Add (string text, string imageKey);
public virtual System.Windows.Forms.ListViewItem Add (string? text, string? imageKey);
abstract member Add : string * string -> System.Windows.Forms.ListViewItem
override this.Add : string * string -> System.Windows.Forms.ListViewItem
Public Overridable Function Add (text As String, imageKey As String) As ListViewItem

Parametry

text
String

Text položky

imageKey
String

Klíč obrázku, který se má zobrazit pro položku.

Návraty

ListViewItem

Přidaný ListViewItem do kolekce.

Poznámky

ListView Pokud je položka seřazená, přidá se ve správném pořadí. V opačném případě se přidá na konec kolekce.

Platí pro

Add(String, String, Int32)

Vytvoří položku se zadaným klíčem, textem a obrázkem a přidá položku do kolekce.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ key, System::String ^ text, int imageIndex);
public virtual System.Windows.Forms.ListViewItem Add (string key, string text, int imageIndex);
public virtual System.Windows.Forms.ListViewItem Add (string? key, string? text, int imageIndex);
abstract member Add : string * string * int -> System.Windows.Forms.ListViewItem
override this.Add : string * string * int -> System.Windows.Forms.ListViewItem
Public Overridable Function Add (key As String, text As String, imageIndex As Integer) As ListViewItem

Parametry

key
String

Název položky.

text
String

Text položky

imageIndex
Int32

Index obrázku, který se má zobrazit pro položku.

Návraty

ListViewItem

Přidaný ListViewItem do kolekce.

Výjimky

InvalidOperationException

Obsahující ListView je ve virtuálním režimu.

Poznámky

ListView Pokud je položka seřazená, přidá se ve správném pořadí. V opačném případě se přidá na konec kolekce. Vlastnost Name odpovídá klíči pro objekt ListViewItem v objektu ListView.ListViewItemCollection.

Metoda Add nastaví Name vlastnost na zadaný klíč, takže položku lze načíst pomocí indexu nebo klíče.

Platí pro

Add(String, String, String)

Vytvoří položku se zadaným klíčem, textem a obrázkem a přidá ji do kolekce.

public:
 virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ key, System::String ^ text, System::String ^ imageKey);
public virtual System.Windows.Forms.ListViewItem Add (string key, string text, string imageKey);
public virtual System.Windows.Forms.ListViewItem Add (string? key, string? text, string? imageKey);
abstract member Add : string * string * string -> System.Windows.Forms.ListViewItem
override this.Add : string * string * string -> System.Windows.Forms.ListViewItem
Public Overridable Function Add (key As String, text As String, imageKey As String) As ListViewItem

Parametry

key
String

Název položky.

text
String

Text položky

imageKey
String

Klíč obrázku, který se má zobrazit pro položku.

Návraty

ListViewItem

Přidaný ListViewItem do kolekce.

Poznámky

Vlastnost Name odpovídá klíči pro objekt ListViewItem v objektu ListView.ListViewItemCollection.

ListView Pokud je položka seřazená, přidá se ve správném pořadí. V opačném případě se přidá na konec kolekce. Metoda Add nastaví Name vlastnost položky na zadaný klíč, takže položku lze načíst pomocí jejího indexu nebo klíče.

Platí pro