ListView.ListViewItemCollection.Insert Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee voegt u een item toe aan de verzameling op de opgegeven index.
Overloads
| Name | Description |
|---|---|
| Insert(Int32, String, String, String) |
Hiermee maakt u een nieuw item met de opgegeven sleutel, tekst en afbeelding en voegt u dit toe aan de verzameling op de opgegeven index. |
| Insert(Int32, String, String, Int32) |
Hiermee maakt u een nieuw item met de opgegeven sleutel, tekst en afbeelding en voegt u het in de verzameling in de opgegeven index in. |
| Insert(Int32, String, String) |
Hiermee maakt u een nieuw item met de opgegeven tekst en afbeelding en voegt u dit in de verzameling in de opgegeven index in. |
| Insert(Int32, ListViewItem) |
Hiermee voegt u een bestaande ListViewItem in de verzameling in de opgegeven index in. |
| Insert(Int32, String) |
Hiermee maakt u een nieuw item en voegt u dit in de verzameling in de opgegeven index in. |
| Insert(Int32, String, Int32) |
Hiermee maakt u een nieuw item met de opgegeven afbeeldingsindex en voegt u dit in de verzameling in de opgegeven index in. |
Insert(Int32, String, String, String)
Hiermee maakt u een nieuw item met de opgegeven sleutel, tekst en afbeelding en voegt u dit toe aan de verzameling op de opgegeven index.
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 ListViewItemParameters
- index
- Int32
De op nul gebaseerde indexlocatie waar het item wordt ingevoegd.
- text
- String
De tekst van het item.
- imageKey
- String
De sleutel van de afbeelding die voor het item moet worden weergegeven.
Retouren
De ListViewItem toegevoegde aan de verzameling.
Uitzonderingen
De index parameter is kleiner dan 0 of groter dan de waarde van de Count eigenschap van de ListView.ListViewItemCollection.
Opmerkingen
Met Insert de methode wordt de Name eigenschap van het item ingesteld op de opgegeven sleutel, zodat het item kan worden opgehaald door de index of de sleutel.
Van toepassing op
Insert(Int32, String, String, Int32)
Hiermee maakt u een nieuw item met de opgegeven sleutel, tekst en afbeelding en voegt u het in de verzameling in de opgegeven index in.
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 ListViewItemParameters
- index
- Int32
De op nul gebaseerde indexlocatie waar het item wordt ingevoegd.
- text
- String
De tekst van het item.
- imageIndex
- Int32
De index van de afbeelding die voor het item moet worden weergegeven.
Retouren
De ListViewItem toegevoegde aan de verzameling.
Uitzonderingen
De index parameter is kleiner dan 0 of groter dan de waarde van de Count eigenschap van de ListView.ListViewItemCollection.
Opmerkingen
Met Insert de methode wordt de Name eigenschap van het item ingesteld op de opgegeven sleutel, zodat het item kan worden opgehaald door de index of de sleutel.
Van toepassing op
Insert(Int32, String, String)
Hiermee maakt u een nieuw item met de opgegeven tekst en afbeelding en voegt u dit in de verzameling in de opgegeven index in.
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 ListViewItemParameters
- index
- Int32
De op nul gebaseerde indexlocatie waar het item wordt ingevoegd.
- text
- String
De tekst van de ListViewItem.
- imageKey
- String
De sleutel van de afbeelding die voor het item moet worden weergegeven.
Retouren
De ListViewItem toegevoegde aan de verzameling.
Uitzonderingen
De index parameter is kleiner dan 0 of groter dan de waarde van de Count eigenschap van de ListView.ListViewItemCollection.
Van toepassing op
Insert(Int32, ListViewItem)
Hiermee voegt u een bestaande ListViewItem in de verzameling in de opgegeven index in.
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 ListViewItemParameters
- index
- Int32
De op nul gebaseerde indexlocatie waar het item wordt ingevoegd.
- item
- ListViewItem
Het ListViewItem item dat moet worden ingevoegd.
Retouren
De ListViewItem gegevens die in de verzameling zijn ingevoegd.
Uitzonderingen
De index parameter is kleiner dan 0 of groter dan de waarde van de Count eigenschap van de ListView.ListViewItemCollection.
Opmerkingen
Met deze versie van de Insert methode kunt u een bestaande ListViewItem invoegen op een specifieke positie in de ListView.ListViewItemCollection.
Note
Als de ListView.Sorting eigenschap is ingesteld op een andere waarde dan SortOrder.None of als de ListViewItemSorter eigenschap is ingesteld, wordt de lijst gesorteerd nadat het item is ingevoegd.
Als u een item wilt toevoegen zonder een specifieke positie in de verzameling op te geven om het item toe te voegen, gebruikt u de Add methode. Als u een matrix met items wilt toevoegen aan de verzameling, gebruikt u de AddRange methode. U kunt deze methode gebruiken als u een nieuw item wilt invoegen in een bestaande verzameling items.
Zie ook
Van toepassing op
Insert(Int32, String)
Hiermee maakt u een nieuw item en voegt u dit in de verzameling in de opgegeven index in.
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 ListViewItemParameters
- index
- Int32
De op nul gebaseerde indexlocatie waar het item wordt ingevoegd.
- text
- String
De tekst die moet worden weergegeven voor het item.
Retouren
De ListViewItem gegevens die in de verzameling zijn ingevoegd.
Uitzonderingen
De index parameter is kleiner dan 0 of groter dan de waarde van de Count eigenschap van de ListView.ListViewItemCollection.
Opmerkingen
Met deze versie van de Insert methode kunt u een nieuw item invoegen op een specifieke positie in de ListView.ListViewItemCollection. De tekst die in de text parameter is opgegeven, wordt gebruikt om een nieuwe ListViewItem te maken die vervolgens op de ListView.ListViewItemCollection opgegeven locatie wordt ingevoegd.
Note
Als de ListView.Sorting eigenschap is ingesteld op een andere waarde dan SortOrder.None of als de ListViewItemSorter eigenschap is ingesteld, wordt de lijst gesorteerd nadat het item is ingevoegd.
Als u een item wilt toevoegen zonder een specifieke positie in de verzameling op te geven, gebruikt u de Add methode. Als u een matrix met items wilt toevoegen aan de verzameling, gebruikt u de AddRange methode. U kunt deze methode gebruiken als u een nieuw item wilt invoegen in een bestaande verzameling items.
Zie ook
Van toepassing op
Insert(Int32, String, Int32)
Hiermee maakt u een nieuw item met de opgegeven afbeeldingsindex en voegt u dit in de verzameling in de opgegeven index in.
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 ListViewItemParameters
- index
- Int32
De op nul gebaseerde indexlocatie waar het item wordt ingevoegd.
- text
- String
De tekst die moet worden weergegeven voor het item.
- imageIndex
- Int32
De index van de afbeelding die voor het item moet worden weergegeven.
Retouren
De ListViewItem gegevens die in de verzameling zijn ingevoegd.
Uitzonderingen
De index parameter is kleiner dan 0 of groter dan de waarde van de Count eigenschap van de ListView.ListViewItemCollection.
Opmerkingen
Met deze versie van de Insert methode kunt u een nieuw item invoegen op een specifieke positie in de ListView.ListViewItemCollection. De tekst die in de text parameter is opgegeven, wordt gebruikt om een nieuwe ListViewItem te maken die vervolgens op de ListView.ListViewItemCollection opgegeven locatie wordt ingevoegd.
Note
Als de ListView.Sorting eigenschap is ingesteld op een andere waarde dan SortOrder.None of als de ListViewItemSorter eigenschap is ingesteld, wordt de lijst gesorteerd nadat het item is ingevoegd.
U kunt deze versie van de Insert methode ook gebruiken om een afbeelding voor het item op te geven door de index van de ImageList toegewezen aan de ListView.LargeImageList parameter en ListView.SmallImageList eigenschappen door te imageIndex geven. (Normaal gesproken gebruiken de ListView.LargeImageList en ListView.SmallImageList eigenschappen dezelfde indexposities om gerelateerde afbeeldingen weer te geven.) Als u geen afbeeldingsindex voor het item wilt opgeven, gebruikt u de andere versie van de Insert methode die een tekenreeks als parameter accepteert.
Als u een item wilt toevoegen zonder een specifieke positie in de verzameling op te geven, gebruikt u de Add methode. Als u een matrix met items wilt toevoegen aan de verzameling, gebruikt u de AddRange methode.
