ListView.ListViewItemCollection.Insert Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Vloží položku do kolekce v zadaném indexu.
Přetížení
| Name | Description |
|---|---|
| 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ží do kolekce existující ListViewItem 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 image 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.ListViewItemPublic Overridable Function Insert (index As Integer, key As String, text As String, imageKey As String) As ListViewItemParametry
- index
- Int32
Umístění indexu založeného na nule, kam je položka vložena.
- 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í jeho 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.ListViewItemPublic Overridable Function Insert (index As Integer, key As String, text As String, imageIndex As Integer) As ListViewItemParametry
- index
- Int32
Umístění indexu založeného na nule, kam je položka vložena.
- 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í jeho 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.ListViewItemPublic Function Insert (index As Integer, text As String, imageKey As String) As ListViewItemParametry
- index
- Int32
Umístění indexu založeného na nule, kam je položka vložena.
- text
- String
Text .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ží do kolekce existující ListViewItem 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.ListViewItemPublic Function Insert (index As Integer, item As ListViewItem) As ListViewItemParametry
- index
- Int32
Umístění indexu založeného na nule, kam je položka vložena.
- item
- ListViewItem
Představuje ListViewItem položku, kterou chcete vložit.
Návraty
Ten ListViewItem byl vložen 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 vlastnost nastavena, seznam se seřadí po vložení položky.
Chcete-li přidat položku bez zadání konkrétní pozice v kolekci přidat položku, 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.ListViewItemPublic Function Insert (index As Integer, text As String) As ListViewItemParametry
- 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
Ten ListViewItem byl vložen 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 slouží 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 vlastnost nastavena, seznam se seřadí po vložení položky.
Chcete-li 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 image 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.ListViewItemPublic Function Insert (index As Integer, text As String, imageIndex As Integer) As ListViewItemParametry
- 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
Ten ListViewItem byl vložen 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 slouží 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 vlastnost nastavena, seznam se seřadí po vložení položky.
Tuto verzi Insert metody můžete také použít k určení obrázku pro položku předáním indexu přiřazeného ImageList k ListView.LargeImageList parametru a ListView.SmallImageList vlastnostem imageIndex . (K zobrazení souvisejících obrázků obvykle ListView.LargeImageList používají stejné pozice indexu a ListView.SmallImageList vlastnosti.) Pokud nechcete pro položku zadat index obrázku, použijte druhou verzi Insert metody, která přijímá řetězec jako parametr.
Chcete-li 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 .
