ListView.ListViewItemCollection.Insert Metoda

public:
 virtual System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ key, System::String ^ text, System::String ^ imageKey);

public virtual System.Windows.Forms.ListViewItem Insert (int index, string key, string text, string imageKey);

public virtual System.Windows.Forms.ListViewItem Insert (int index, string? key, string? text, string? imageKey);

abstract member Insert : int * string * string * string -> System.Windows.Forms.ListViewItem
override this.Insert : int * string * string * string -> System.Windows.Forms.ListViewItem

Public Overridable Function Insert (index As Integer, key As String, text As String, imageKey As String) As ListViewItem

Parametry

Návraty

Přidaný ListViewItem do kolekce.

Výjimky

Poznámky

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

public:
 virtual System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ key, System::String ^ text, int imageIndex);

public virtual System.Windows.Forms.ListViewItem Insert (int index, string key, string text, int imageIndex);

public virtual System.Windows.Forms.ListViewItem Insert (int index, string? key, string? text, int imageIndex);

abstract member Insert : int * string * string * int -> System.Windows.Forms.ListViewItem
override this.Insert : int * string * string * int -> System.Windows.Forms.ListViewItem

Public Overridable Function Insert (index As Integer, key As String, text As String, imageIndex As Integer) As ListViewItem

Parametry

Návraty

Přidaný ListViewItem do kolekce.

Výjimky

Poznámky

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

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text, System::String ^ imageKey);

public System.Windows.Forms.ListViewItem Insert (int index, string text, string imageKey);

public System.Windows.Forms.ListViewItem Insert (int index, string? text, string? imageKey);

member this.Insert : int * string * string -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, text As String, imageKey As String) As ListViewItem

Parametry

Návraty

Přidaný ListViewItem do kolekce.

Výjimky

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::Windows::Forms::ListViewItem ^ item);

public System.Windows.Forms.ListViewItem Insert (int index, System.Windows.Forms.ListViewItem item);

member this.Insert : int * System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, item As ListViewItem) As ListViewItem

Parametry

Návraty

Hodnota ListViewItem , která byla vložena do kolekce.

Výjimky

Poznámky

Tato verze Insert metody umožňuje vložit existující ListViewItem na konkrétní pozici v objektu ListView.ListViewItemCollection.

Pokud chcete přidat položku bez zadání konkrétní pozice v kolekci pro přidání položky, použijte metodu Add . Pokud chcete do kolekce přidat pole položek, použijte metodu AddRange . Tuto metodu můžete použít, pokud chcete vložit novou položku do existující kolekce položek.

Viz také

• Add(String)
• AddRange(ListViewItem[])

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text);

public System.Windows.Forms.ListViewItem Insert (int index, string text);

public System.Windows.Forms.ListViewItem Insert (int index, string? text);

member this.Insert : int * string -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, text As String) As ListViewItem

Parametry

Návraty

Hodnota ListViewItem , která byla vložena do kolekce.

Výjimky

Poznámky

Tato verze Insert metody umožňuje vložit novou položku na konkrétní pozici v objektu ListView.ListViewItemCollection. Text zadaný v parametru text se použije k vytvoření nového ListViewItem , který se pak vloží do ListView.ListViewItemCollection zadaného umístění.

Pokud chcete přidat položku bez zadání konkrétní pozice v kolekci, použijte metodu Add . Pokud chcete do kolekce přidat pole položek, použijte metodu AddRange . Tuto metodu můžete použít, pokud chcete vložit novou položku do existující kolekce položek.

Viz také

• Add(String)
• AddRange(ListViewItem[])

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::String ^ text, int imageIndex);

public System.Windows.Forms.ListViewItem Insert (int index, string text, int imageIndex);

public System.Windows.Forms.ListViewItem Insert (int index, string? text, int imageIndex);

member this.Insert : int * string * int -> System.Windows.Forms.ListViewItem

Public Function Insert (index As Integer, text As String, imageIndex As Integer) As ListViewItem

Parametry

Návraty

Hodnota ListViewItem , která byla vložena do kolekce.

Výjimky

Poznámky

Tato verze Insert metody umožňuje vložit novou položku na konkrétní pozici v objektu ListView.ListViewItemCollection. Text zadaný v parametru text se použije k vytvoření nového ListViewItem , který se pak vloží do ListView.ListViewItemCollection zadaného umístění.

Tuto verzi Insert metody můžete použít také k určení obrázku pro položku předáním indexu ImageList přiřazených vlastnostem ListView.LargeImageList a ListView.SmallImageList 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 druhou verzi Insert metody, která přijímá řetězec jako parametr.

Pokud chcete přidat položku bez zadání konkrétní pozice v kolekci, použijte metodu Add . Pokud chcete do kolekce přidat pole položek, použijte metodu AddRange .

Viz také

• Add(String)
• AddRange(ListViewItem[])