ListView.ListViewItemCollection.Insert Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Fügt ein Element am angegebenen Index in die Auflistung ein.
Überlädt
| Insert(Int32, String, String, String) |
Erstellt ein neues Element mit dem angegebenen Schlüssel, dem Text und dem Bild und fügt es der Auflistung am angegebenen Index hinzu. |
| Insert(Int32, String, String, Int32) |
Erstellt ein neues Element mit dem angegebenen Schlüssel, dem Text und dem Bild und fügt es am angegebenen Index in die Auflistung ein. |
| Insert(Int32, String, String) |
Erstellt ein neues Element mit dem dem angegebenen Text und dem angegebenen Bild und fügt es am angegebenen Index in die Auflistung ein. |
| Insert(Int32, ListViewItem) |
Fügt ein bestehendes ListViewItem am angegebenen Index in die Auflistung ein. |
| Insert(Int32, String) |
Erstellt ein neues Element und fügt es am angegebenen Index in die Auflistung ein. |
| Insert(Int32, String, Int32) |
Erstellt ein neues Element mit dem angegebenen Bildtext und fügt es an der angegebenen Indexposition in die Auflistung ein. |
Insert(Int32, String, String, String)
Erstellt ein neues Element mit dem angegebenen Schlüssel, dem Text und dem Bild und fügt es der Auflistung am angegebenen Index hinzu.
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 ListViewItemParameter
- index
- Int32
Der nullbasierte Indexspeicherort, in den das Element eingefügt wird.
- text
- String
Der Text des Elements.
- imageKey
- String
Der Schlüssel des Bilds, der für das Element angezeigt werden soll.
Gibt zurück
Das der Auflistung hinzugefügte ListViewItem.
Ausnahmen
Der index-Parameter ist kleiner als 0 (null) oder größer als der Wert der Count-Eigenschaft der ListView.ListViewItemCollection.
Hinweise
Die Insert -Methode legt die Name -Eigenschaft des Elements auf den angegebenen Schlüssel fest, sodass das Element mit seinem Index oder nach Schlüssel abgerufen werden kann.
Gilt für:
Insert(Int32, String, String, Int32)
Erstellt ein neues Element mit dem angegebenen Schlüssel, dem Text und dem Bild und fügt es am angegebenen Index in die Auflistung ein.
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 ListViewItemParameter
- index
- Int32
Der nullbasierte Indexspeicherort, in den das Element eingefügt wird.
- text
- String
Der Text des Elements.
- imageIndex
- Int32
Der Index des Bilds, der für das Element angezeigt werden soll.
Gibt zurück
Das der Auflistung hinzugefügte ListViewItem.
Ausnahmen
Der index-Parameter ist kleiner als 0 (null) oder größer als der Wert der Count-Eigenschaft der ListView.ListViewItemCollection.
Hinweise
Die Insert -Methode legt die Name -Eigenschaft des Elements auf den angegebenen Schlüssel fest, sodass das Element mit seinem Index oder nach Schlüssel abgerufen werden kann.
Gilt für:
Insert(Int32, String, String)
Erstellt ein neues Element mit dem dem angegebenen Text und dem angegebenen Bild und fügt es am angegebenen Index in die Auflistung ein.
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 ListViewItemParameter
- index
- Int32
Der nullbasierte Indexspeicherort, in den das Element eingefügt wird.
- text
- String
Der Text der ListViewItem.
- imageKey
- String
Der Schlüssel des Bilds, der für das Element angezeigt werden soll.
Gibt zurück
Das der Auflistung hinzugefügte ListViewItem.
Ausnahmen
Der index-Parameter ist kleiner als 0 (null) oder größer als der Wert der Count-Eigenschaft der ListView.ListViewItemCollection.
Gilt für:
Insert(Int32, ListViewItem)
Fügt ein bestehendes ListViewItem am angegebenen Index in die Auflistung ein.
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 ListViewItemParameter
- index
- Int32
Der nullbasierte Indexspeicherort, in den das Element eingefügt wird.
- item
- ListViewItem
Das ListViewItem, das das einzufügende Element darstellt.
Gibt zurück
Das ListViewItem, das in die Auflistung eingefügt wurde.
Ausnahmen
Der index-Parameter ist kleiner als 0 (null) oder größer als der Wert der Count-Eigenschaft der ListView.ListViewItemCollection.
Hinweise
Mit dieser Version der Insert -Methode können Sie ein vorhandenes ListViewItem an einer bestimmten Position im ListView.ListViewItemCollectioneinfügen.
Hinweis
Wenn die ListView.Sorting Eigenschaft auf einen anderen Wert als SortOrder.None oder festgelegt ist, wird die ListViewItemSorter Liste nach dem Einfügen des Elements sortiert.
Verwenden Sie die Add -Methode, um ein Element hinzuzufügen, ohne eine bestimmte Position in der Auflistung anzugeben, um das Element hinzuzufügen. Wenn Sie der Auflistung ein Array von Elementen hinzufügen möchten, verwenden Sie die AddRange -Methode. Sie können diese Methode verwenden, wenn Sie ein neues Element in eine vorhandene Auflistung von Elementen einfügen möchten.
Weitere Informationen
Gilt für:
Insert(Int32, String)
Erstellt ein neues Element und fügt es am angegebenen Index in die Auflistung ein.
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 ListViewItemParameter
- index
- Int32
Der nullbasierte Indexspeicherort, in den das Element eingefügt wird.
- text
- String
Der für das Element anzuzeigende Text.
Gibt zurück
Das ListViewItem, das in die Auflistung eingefügt wurde.
Ausnahmen
Der index-Parameter ist kleiner als 0 (null) oder größer als der Wert der Count-Eigenschaft der ListView.ListViewItemCollection.
Hinweise
Mit dieser Version der Insert -Methode können Sie ein neues Element an einer bestimmten Position im ListView.ListViewItemCollectioneinfügen. Der im text Parameter angegebene Text wird verwendet, um eine neue ListViewItem zu erstellen, die dann an der angegebenen Position in die ListView.ListViewItemCollection eingefügt wird.
Hinweis
Wenn die ListView.Sorting Eigenschaft auf einen anderen Wert als SortOrder.None oder festgelegt ist, wird die ListViewItemSorter Liste nach dem Einfügen des Elements sortiert.
Verwenden Sie die Add -Methode, um ein Element hinzuzufügen, ohne eine bestimmte Position in der Auflistung anzugeben. Wenn Sie der Auflistung ein Array von Elementen hinzufügen möchten, verwenden Sie die AddRange -Methode. Sie können diese Methode verwenden, wenn Sie ein neues Element in eine vorhandene Auflistung von Elementen einfügen möchten.
Weitere Informationen
Gilt für:
Insert(Int32, String, Int32)
Erstellt ein neues Element mit dem angegebenen Bildtext und fügt es an der angegebenen Indexposition in die Auflistung ein.
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 ListViewItemParameter
- index
- Int32
Der nullbasierte Indexspeicherort, in den das Element eingefügt wird.
- text
- String
Der für das Element anzuzeigende Text.
- imageIndex
- Int32
Der Index des Bilds, der für das Element angezeigt werden soll.
Gibt zurück
Das ListViewItem, das in die Auflistung eingefügt wurde.
Ausnahmen
Der index-Parameter ist kleiner als 0 (null) oder größer als der Wert der Count-Eigenschaft der ListView.ListViewItemCollection.
Hinweise
Mit dieser Version der Insert -Methode können Sie ein neues Element an einer bestimmten Position im ListView.ListViewItemCollectioneinfügen. Der im text Parameter angegebene Text wird verwendet, um eine neue ListViewItem zu erstellen, die dann an der angegebenen Position in die ListView.ListViewItemCollection eingefügt wird.
Hinweis
Wenn die ListView.Sorting Eigenschaft auf einen anderen Wert als SortOrder.None oder festgelegt ist, wird die ListViewItemSorter Liste nach dem Einfügen des Elements sortiert.
Sie können diese Version der Insert -Methode auch verwenden, um ein Image für das Element anzugeben, indem Sie den Index der ImageList zugewiesenen Eigenschaften und ListView.SmallImageList an ListView.LargeImageList den imageIndex Parameter übergeben. (In der Regel verwenden die ListView.LargeImageList Eigenschaften und ListView.SmallImageList dieselben Indexpositionen, um verwandte Bilder anzuzeigen.) Wenn Sie keinen Imageindex für das Element angeben möchten, verwenden Sie die andere Version der Methode, die Insert eine Zeichenfolge als Parameter akzeptiert.
Verwenden Sie die Add -Methode, um ein Element hinzuzufügen, ohne eine bestimmte Position in der Auflistung anzugeben. Wenn Sie der Auflistung ein Array von Elementen hinzufügen möchten, verwenden Sie die AddRange -Methode.
