ListView.ListViewItemCollection.Add Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

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

Přetížení

Name	Description
Add(String)	Vytvoří položku se zadaným textem a přidá ji do kolekce.
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)	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)

Zdroj:

ListView.ListViewItemCollection.cs

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

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

Ta ListViewItem 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 ovládacího prvku je založený na parametru text . Pokud chcete zadat obrázek pro položku, použijte verzi Add metody, která přijímá index obrázku jako parametr. Pokud máte existující ListViewItem , který chcete přidat do kolekce, použijte verzi Add metody, která přijímá ListViewItem jako jeho 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 pomocí Insert metody vložit položku do ListView určité pozice. Chcete-li přidat sadu položek do ovládacího prvku v jedné operaci, použijte metodu AddRange . Pokud chcete metodu Add použít k přidání velkého počtu položek do ovládacího prvku, použijte a BeginUpdateEndUpdate metody, aby se zabránilo opětovnému nakreslení všech položek, dokud nebudou ListView přidány všechny položky. Při přidávání položek do souboru ListViewje efektivnější položky nejprve seřadit a pak přidat nové položky.

Viz také

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

Add(ListViewItem)

Zdroj:

ListView.ListViewItemCollection.cs

Přidá existující ListViewItem kolekci.

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ání ListViewItem do kolekce.

Návraty

ListViewItem

Ta ListViewItem 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 byla vytvořena ručně před přidáním do kolekce. Pokud chcete vytvořit novou ListViewItem místo existující položky, 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 pomocí Insert metody vložit položku do ListView určité pozice. Chcete-li přidat sadu položek do ovládacího prvku v jedné operaci, použijte metodu AddRange . Pokud chcete metodu Add použít k přidání velkého počtu položek do ovládacího prvku, použijte a BeginUpdateEndUpdate metody, aby se zabránilo opětovnému nakreslení všech položek, dokud nebudou ListView přidány všechny položky. Při přidávání položek do souboru ListViewje efektivnější položky nejprve seřadit a pak přidat nové položky.

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

Viz také

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

Add(String, Int32)

Zdroj:

ListView.ListViewItemCollection.cs

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

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

Ta ListViewItem 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 ovládacího prvku je založený na parametru text . Můžete také zadat obrázek pro položku předáním indexu přiřazeného ImageListListView.LargeImageList parametru a ListView.SmallImageList vlastnostem parametru imageIndex . (K zobrazení souvisejících obrázků obvykle ListView.LargeImageList používají stejné pozice indexu a ListView.SmallImageList vlastnosti.) Pokud nechcete zadat index obrázku pro položku, použijte verzi Add metody, která přijímá pouze řetězec jako parametr. Pokud máte existující ListViewItem , který chcete přidat do kolekce, použijte verzi Add metody, která přijímá ListViewItem jako jeho 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 pomocí Insert metody vložit položku do ListView určité pozice. Chcete-li přidat sadu položek do ovládacího prvku v jedné operaci, použijte metodu AddRange . Pokud chcete metodu Add použít k přidání velkého počtu položek do ovládacího prvku, použijte a BeginUpdateEndUpdate metody, aby se zabránilo opětovnému nakreslení všech položek, dokud nebudou ListView přidány všechny položky. Při přidávání položek do souboru ListViewje efektivnější položky nejprve seřadit a pak přidat nové položky.

Viz také

• AddRange(ListViewItem[])
• Insert(Int32, ListViewItem)
• Sorting

Add(String, String)

Zdroj:

ListView.ListViewItemCollection.cs

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

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 do správně seřazeného pořadí. V opačném případě se přidá na konec kolekce.

Add(String, String, Int32)

Zdroj:

ListView.ListViewItemCollection.cs

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

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

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

Poznámky

ListView Pokud je položka seřazená, přidá se do správně seřazeného pořadí. V opačném případě se přidá na konec kolekce. Vlastnost Name odpovídá klíči 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.

Add(String, String, String)

Zdroj:

ListView.ListViewItemCollection.cs

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

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 ListViewItem v objektu ListView.ListViewItemCollection.

ListView Pokud je položka seřazená, přidá se do správně seřazeného 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í jeho indexu nebo klíče.