ListView.ListViewItemCollection.Insert Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Vloží položku do kolekce v zadaném indexu.

Přetížení

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, 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)	Vytvoří novou položku se zadaným textem a obrázkem a vloží ji do kolekce v zadaném indexu.
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, String)

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

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

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

index

Int32

Umístění indexu založeného na nule, kam je položka vložena.

key

String

Položka Name 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.

Výjimky

ArgumentOutOfRangeException

Parametr index je menší než 0 nebo větší než hodnota Count vlastnosti ListView.ListViewItemCollection.

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.

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.

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

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

index

Int32

Umístění indexu založeného na nule, kam je položka vložena.

key

String

Položka Name 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

ArgumentOutOfRangeException

Parametr index je menší než 0 nebo větší než hodnota Count vlastnosti ListView.ListViewItemCollection.

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.

Insert(Int32, String, String)

Vytvoří novou položku se zadaným textem a obrázkem a vloží ji do kolekce v zadaném indexu.

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

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

index

Int32

Umístění indexu založeného na nule, kam je položka vložena.

text

String

Text souboru ListViewItem.

imageKey

String

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

Návraty

ListViewItem

Přidaný ListViewItem do kolekce.

Výjimky

ArgumentOutOfRangeException

Parametr index je menší než 0 nebo větší než hodnota Count vlastnosti ListView.ListViewItemCollection.

Insert(Int32, ListViewItem)

Vloží existující ListViewItem do kolekce v zadaném indexu.

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

index

Int32

Umístění indexu založeného na nule, kam je položka vložena.

item

ListViewItem

Představuje ListViewItem položku, která se má vložit.

Návraty

ListViewItem

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

Výjimky

ArgumentOutOfRangeException

Parametr index je menší než 0 nebo větší než hodnota Count vlastnosti ListView.ListViewItemCollection.

Poznámky

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

Poznámka

ListView.Sorting Pokud je vlastnost nastavena na jinou hodnotu než SortOrder.None nebo pokud ListViewItemSorter je nastavena vlastnost, je seznam seřazen po vložení položky.

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[])

Insert(Int32, String)

Vytvoří novou položku a vloží ji do kolekce v zadaném indexu.

public:
 System::Windows::Forms::ListViewItem ^ Insert(int index, System::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

index

Int32

Umístění indexu založeného na nule, kam je položka vložena.

text

String

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

Návraty

ListViewItem

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

Výjimky

ArgumentOutOfRangeException

Parametr index je menší než 0 nebo větší než hodnota Count vlastnosti ListView.ListViewItemCollection.

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í.

Poznámka

ListView.Sorting Pokud je vlastnost nastavena na jinou hodnotu než SortOrder.None nebo pokud ListViewItemSorter je nastavena vlastnost, je seznam seřazen po vložení položky.

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[])

Insert(Int32, String, Int32)

Vytvoří novou položku se zadaným indexem obrázku a vloží ji do kolekce v zadaném indexu.

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

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

index

Int32

Umístění indexu založeného na nule, kam je položka vložena.

text

String

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

imageIndex

Int32

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

Návraty

ListViewItem

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

Výjimky

ArgumentOutOfRangeException

Parametr index je menší než 0 nebo větší než hodnota Count vlastnosti ListView.ListViewItemCollection.

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í.

Poznámka

ListView.Sorting Pokud je vlastnost nastavena na jinou hodnotu než SortOrder.None nebo pokud ListViewItemSorter je nastavena vlastnost, je seznam seřazen po vložení položky.

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[])