ListView.ListViewItemCollection.Add 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 items.
Overloads
| Name | Description |
|---|---|
| Add(String) |
Hiermee maakt u een item met de opgegeven tekst en voegt u dit toe aan de verzameling. |
| Add(ListViewItem) |
Voegt een bestaande ListViewItem aan de verzameling toe. |
| Add(String, Int32) |
Hiermee maakt u een item met de opgegeven tekst en afbeelding en voegt u dit toe aan de verzameling. |
| Add(String, String) |
Hiermee maakt u een item met de opgegeven tekst en afbeelding en voegt u dit toe aan de verzameling. |
| Add(String, String, Int32) |
Hiermee maakt u een item met de opgegeven sleutel, tekst en afbeelding en voegt u een item toe aan de verzameling. |
| Add(String, String, String) |
Hiermee maakt u een item met de opgegeven sleutel, tekst en afbeelding en voegt u het toe aan de verzameling. |
Add(String)
Hiermee maakt u een item met de opgegeven tekst en voegt u dit toe aan de verzameling.
public:
virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text);public virtual System.Windows.Forms.ListViewItem Add(string text);public virtual System.Windows.Forms.ListViewItem Add(string? text);abstract member Add : string -> System.Windows.Forms.ListViewItem
override this.Add : string -> System.Windows.Forms.ListViewItemPublic Overridable Function Add (text As String) As ListViewItemParameters
- text
- String
De tekst die moet worden weergegeven voor het item.
Retouren
De ListViewItem gegevens die aan de verzameling zijn toegevoegd.
Opmerkingen
U kunt deze versie van de Add methode gebruiken om een nieuw ListViewItem besturingselement te maken ListView . De tekst van het nieuwe ListViewItem toegevoegd aan het besturingselement is gebaseerd op de text parameter. Als u een afbeelding voor het item wilt opgeven, gebruikt u de versie van de Add methode die een afbeeldingsindex accepteert als parameter. Als u een bestaande ListViewItem verzameling wilt toevoegen, gebruikt u de versie van de Add methode die een ListViewItem parameter als parameter accepteert.
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 toegevoegd. Anders wordt het item aan het einde van de lijst ingevoegd. Als de lijst niet is gesorteerd, kunt u de Insert methode gebruiken om een item op een specifieke positie in te ListView voegen. Gebruik de AddRange methode om een set items toe te voegen aan het besturingselement in één bewerking. Als u de Add methode wilt gebruiken om een groot aantal items aan het besturingselement toe te voegen, gebruikt u de BeginUpdate en EndUpdate methoden om te voorkomen dat de ListView items opnieuw worden geschilderd totdat alle items worden toegevoegd. Wanneer u items toevoegt aan een ListView, is het efficiënter om de items eerst te sorteren en vervolgens nieuwe items toe te voegen.
Zie ook
Van toepassing op
Add(ListViewItem)
Voegt een bestaande ListViewItem aan de verzameling toe.
public:
virtual System::Windows::Forms::ListViewItem ^ Add(System::Windows::Forms::ListViewItem ^ value);public virtual System.Windows.Forms.ListViewItem Add(System.Windows.Forms.ListViewItem value);abstract member Add : System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItem
override this.Add : System.Windows.Forms.ListViewItem -> System.Windows.Forms.ListViewItemPublic Overridable Function Add (value As ListViewItem) As ListViewItemParameters
- value
- ListViewItem
De ListViewItem toe te voegen aan de verzameling.
Retouren
De ListViewItem gegevens die aan de verzameling zijn toegevoegd.
Opmerkingen
U kunt deze versie van de Add methode gebruiken om een bestaande ListViewItem aan de verzameling toe te voegen. Deze versie van de Add methode wordt doorgaans gebruikt om items van andere ListView besturingselementen opnieuw te gebruiken of als de ListViewItem methode handmatig is gemaakt voordat deze aan de verzameling wordt toegevoegd. Als u een nieuw ListViewItem item wilt maken in plaats van een bestaand item te gebruiken, gebruikt u de andere versies van de Add methode.
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 toegevoegd. Anders wordt het item aan het einde van de lijst ingevoegd. Als de lijst niet is gesorteerd, kunt u de Insert methode gebruiken om een item op een specifieke positie in te ListView voegen. Gebruik de AddRange methode om een set items toe te voegen aan het besturingselement in één bewerking. Als u de Add methode wilt gebruiken om een groot aantal items aan het besturingselement toe te voegen, gebruikt u de BeginUpdate en EndUpdate methoden om te voorkomen dat de ListView items opnieuw worden geschilderd totdat alle items worden toegevoegd. Wanneer u items toevoegt aan een ListView, is het efficiënter om de items eerst te sorteren en vervolgens nieuwe items toe te voegen.
Deze versie van de Add methode wordt ook gebruikt om een ListViewItem toe te wijzen aan een ListViewGroup.
Zie ook
Van toepassing op
Add(String, Int32)
Hiermee maakt u een item met de opgegeven tekst en afbeelding en voegt u dit toe aan de verzameling.
public:
virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text, int imageIndex);public virtual System.Windows.Forms.ListViewItem Add(string text, int imageIndex);public virtual System.Windows.Forms.ListViewItem Add(string? text, int imageIndex);abstract member Add : string * int -> System.Windows.Forms.ListViewItem
override this.Add : string * int -> System.Windows.Forms.ListViewItemPublic Overridable Function Add (text As String, imageIndex As Integer) As ListViewItemParameters
- text
- String
De tekst van het item.
- imageIndex
- Int32
De index van de afbeelding die voor het item moet worden weergegeven.
Retouren
De ListViewItem gegevens die aan de verzameling zijn toegevoegd.
Opmerkingen
U kunt deze versie van de Add methode gebruiken om een nieuwe ListViewItem versie te maken die u aan het ListView besturingselement kunt toevoegen. De tekst van het nieuwe ListViewItem toegevoegd aan het besturingselement is gebaseerd op de text parameter. U kunt ook een afbeelding voor het item opgeven door de index van de ImageList toegewezen items ListView.LargeImageList en ListView.SmallImageList eigenschappen door te geven aan de imageIndex parameter. (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 versie van de Add methode die alleen een tekenreeks als parameter accepteert. Als u een bestaande ListViewItem verzameling wilt toevoegen, gebruikt u de versie van de Add methode die een ListViewItem parameter als parameter accepteert.
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 toegevoegd. Anders wordt het item aan het einde van de lijst ingevoegd. Als de lijst niet is gesorteerd, kunt u de Insert methode gebruiken om een item op een specifieke positie in te ListView voegen. Gebruik de AddRange methode om een set items toe te voegen aan het besturingselement in één bewerking. Als u de Add methode wilt gebruiken om een groot aantal items aan het besturingselement toe te voegen, gebruikt u de BeginUpdate en EndUpdate methoden om te voorkomen dat de ListView items opnieuw worden geschilderd totdat alle items worden toegevoegd. Wanneer u items toevoegt aan een ListView, is het efficiënter om de items eerst te sorteren en vervolgens nieuwe items toe te voegen.
Zie ook
Van toepassing op
Add(String, String)
Hiermee maakt u een item met de opgegeven tekst en afbeelding en voegt u dit toe aan de verzameling.
public:
virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ text, System::String ^ imageKey);public virtual System.Windows.Forms.ListViewItem Add(string text, string imageKey);public virtual System.Windows.Forms.ListViewItem Add(string? text, string? imageKey);abstract member Add : string * string -> System.Windows.Forms.ListViewItem
override this.Add : string * string -> System.Windows.Forms.ListViewItemPublic Overridable Function Add (text As String, imageKey As String) As ListViewItemParameters
- 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.
Opmerkingen
Als het ListView item is gesorteerd, wordt het toegevoegd in de correct gesorteerde volgorde. Anders wordt het toegevoegd aan het einde van de verzameling.
Van toepassing op
Add(String, String, Int32)
Hiermee maakt u een item met de opgegeven sleutel, tekst en afbeelding en voegt u een item toe aan de verzameling.
public:
virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ key, System::String ^ text, int imageIndex);public virtual System.Windows.Forms.ListViewItem Add(string key, string text, int imageIndex);public virtual System.Windows.Forms.ListViewItem Add(string? key, string? text, int imageIndex);abstract member Add : string * string * int -> System.Windows.Forms.ListViewItem
override this.Add : string * string * int -> System.Windows.Forms.ListViewItemPublic Overridable Function Add (key As String, text As String, imageIndex As Integer) As ListViewItemParameters
- key
- String
De naam van het item.
- 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
Het bevat ListView zich in de virtuele modus.
Opmerkingen
Als het ListView item is gesorteerd, wordt het toegevoegd in de correct gesorteerde volgorde. Anders wordt het toegevoegd aan het einde van de verzameling. De Name eigenschap komt overeen met de sleutel voor een ListViewItem in de ListView.ListViewItemCollection.
De Add methode stelt de Name eigenschap in op de opgegeven sleutel, zodat het item kan worden opgehaald door de index of de sleutel.
Van toepassing op
Add(String, String, String)
Hiermee maakt u een item met de opgegeven sleutel, tekst en afbeelding en voegt u het toe aan de verzameling.
public:
virtual System::Windows::Forms::ListViewItem ^ Add(System::String ^ key, System::String ^ text, System::String ^ imageKey);public virtual System.Windows.Forms.ListViewItem Add(string key, string text, string imageKey);public virtual System.Windows.Forms.ListViewItem Add(string? key, string? text, string? imageKey);abstract member Add : string * string * string -> System.Windows.Forms.ListViewItem
override this.Add : string * string * string -> System.Windows.Forms.ListViewItemPublic Overridable Function Add (key As String, text As String, imageKey As String) As ListViewItemParameters
- key
- String
De naam van het item.
- 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.
Opmerkingen
De Name eigenschap komt overeen met de sleutel voor een ListViewItem in de ListView.ListViewItemCollection.
Als het ListView item is gesorteerd, wordt het toegevoegd in de correct gesorteerde volgorde. Anders wordt het toegevoegd aan het einde van de verzameling. Met Add 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.
