Sdílet prostřednictvím


ListView.ListViewItemCollection.Insert Metoda

Definice

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

Přidaný ListViewItem do kolekce.

Výjimky

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.

Platí pro

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

Přidaný ListViewItem do kolekce.

Výjimky

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.

Platí pro

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

Přidaný ListViewItem do kolekce.

Výjimky

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

Platí pro

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

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

Výjimky

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é

Platí pro

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

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

Výjimky

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é

Platí pro

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

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

Výjimky

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é

Platí pro