ListView.ListViewItemCollection.Add 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 der Auflistung der Elemente ein Element hinzu.
Überlädt
| Add(String) |
Erstellt ein Element mit dem angegebenen Text und fügt es der Auflistung hinzu. |
| Add(ListViewItem) |
Fügt der Auflistung ein vorhandenes ListViewItem hinzu. |
| Add(String, Int32) |
Erstellt ein Element mit dem angegebenen Text und dem Bild und fügt es der Auflistung hinzu. |
| Add(String, String) |
Erstellt ein Element mit dem angegebenen Text und dem Bild und fügt es der Auflistung hinzu. |
| Add(String, String, Int32) |
Erstellt ein Element mit dem angegebenen Schlüssel, dem Text und dem Bild und fügt der Auflistung ein Element hinzu. |
| Add(String, String, String) |
Erstellt ein Element mit dem angegebenen Schlüssel, Text und Bild und fügt es der Auflistung hinzu. |
Add(String)
Erstellt ein Element mit dem angegebenen Text und fügt es der Auflistung hinzu.
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 ListViewItemParameter
- text
- String
Der für das Element anzuzeigende Text.
Gibt zurück
Das der Auflistung hinzugefügte ListViewItem-Objekt.
Hinweise
Sie können diese Version der Add -Methode verwenden, um eine neue ListViewItem zu erstellen, die einem ListView Steuerelement hinzugefügt werden soll. Der Text des neuen ListViewItem , das dem Steuerelement hinzugefügt wurde, basiert auf dem text -Parameter. Wenn Sie ein Image für das Element angeben möchten, verwenden Sie die Version der -Methode, die Add einen Imageindex als Parameter akzeptiert. Wenn Sie über ein vorhandenes ListViewItem verfügen, das Sie der Auflistung hinzufügen möchten, verwenden Sie die Version der -Methode, die Add als Parameter akzeptiert.ListViewItem
Wenn die ListView.Sorting Eigenschaft auf einen anderen Wert als SortOrder.None oder ListViewItemSorter festgelegt ist, wird die Liste sortiert, nachdem das Element hinzugefügt wurde. Andernfalls wird das Element am Ende der Liste eingefügt. Wenn die Liste nicht sortiert ist, können Sie die Insert -Methode verwenden, um ein Element an einer bestimmten Position in die ListView einzufügen. Verwenden Sie AddRange die -Methode, um dem Steuerelement in einem einzelnen Vorgang einen Satz von Elementen hinzuzufügen. Wenn Sie die Add -Methode verwenden möchten, um dem Steuerelement eine große Anzahl von Elementen hinzuzufügen, verwenden Sie die BeginUpdate Methoden und EndUpdate , um zu verhindern, dass die ListView neu gezeichnet wird, bis alle Elemente hinzugefügt wurden. Beim Hinzufügen von Elementen zu ist ListViewes effizienter, zuerst die Elemente zu sortieren und dann neue Elemente hinzuzufügen.
Weitere Informationen
Gilt für:
Add(ListViewItem)
Fügt der Auflistung ein vorhandenes ListViewItem hinzu.
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 ListViewItemParameter
- value
- ListViewItem
Der der Auflistung hinzuzufügende ListViewItem.
Gibt zurück
Das der Auflistung hinzugefügte ListViewItem-Objekt.
Hinweise
Sie können diese Version der Add -Methode verwenden, um der Auflistung eine vorhandene ListViewItem hinzuzufügen. Diese Version der -Methode wird in der Add Regel verwendet, um Elemente aus anderen ListView Steuerelementen wiederzuverwenden, oder wenn die ListViewItem manuell erstellt wurde, bevor sie der Auflistung hinzugefügt wurde. Wenn Sie ein neues ListViewItem erstellen möchten, anstatt ein vorhandenes Element zu verwenden, verwenden Sie die anderen Versionen der Add -Methode.
Wenn die ListView.Sorting Eigenschaft auf einen anderen Wert als SortOrder.None oder ListViewItemSorter festgelegt ist, wird die Liste sortiert, nachdem das Element hinzugefügt wurde. Andernfalls wird das Element am Ende der Liste eingefügt. Wenn die Liste nicht sortiert ist, können Sie die Insert -Methode verwenden, um ein Element an einer bestimmten Position in die ListView einzufügen. Verwenden Sie AddRange die -Methode, um dem Steuerelement in einem einzelnen Vorgang einen Satz von Elementen hinzuzufügen. Wenn Sie die Add -Methode verwenden möchten, um dem Steuerelement eine große Anzahl von Elementen hinzuzufügen, verwenden Sie die BeginUpdate Methoden und EndUpdate , um zu verhindern, dass die ListView neu gezeichnet wird, bis alle Elemente hinzugefügt wurden. Beim Hinzufügen von Elementen zu ist ListViewes effizienter, zuerst die Elemente zu sortieren und dann neue Elemente hinzuzufügen.
Diese Version der Add -Methode wird auch verwendet, um einem ListViewItemListViewGroupzuzuweisen.
Weitere Informationen
Gilt für:
Add(String, Int32)
Erstellt ein Element mit dem angegebenen Text und dem Bild und fügt es der Auflistung hinzu.
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 ListViewItemParameter
- 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-Objekt.
Hinweise
Sie können diese Version der Add -Methode verwenden, um eine neue ListViewItem zu erstellen, die dem ListView Steuerelement hinzugefügt werden soll. Der Text des neuen ListViewItem , das dem Steuerelement hinzugefügt wurde, basiert auf dem text -Parameter. Sie können auch ein Bild für das Element angeben, indem Sie den Index der ImageList eigenschaften ListView.LargeImageList und ListView.SmallImageList an den imageIndex Parameter übergeben. (In der Regel verwenden die ListView.LargeImageList Eigenschaften und ListView.SmallImageList die gleichen Indexpositionen, um verwandte Bilder anzuzeigen.) Wenn Sie keinen Imageindex für das Element angeben möchten, verwenden Sie die Version der -Methode, die Add nur eine Zeichenfolge als Parameter akzeptiert. Wenn Sie über ein vorhandenes ListViewItem verfügen, das Sie der Auflistung hinzufügen möchten, verwenden Sie die Version der -Methode, die Add als Parameter akzeptiert.ListViewItem
Wenn die ListView.Sorting Eigenschaft auf einen anderen Wert als SortOrder.None oder ListViewItemSorter festgelegt ist, wird die Liste sortiert, nachdem das Element hinzugefügt wurde. Andernfalls wird das Element am Ende der Liste eingefügt. Wenn die Liste nicht sortiert ist, können Sie die Insert -Methode verwenden, um ein Element an einer bestimmten Position in die ListView einzufügen. Verwenden Sie AddRange die -Methode, um dem Steuerelement in einem einzelnen Vorgang einen Satz von Elementen hinzuzufügen. Wenn Sie die Add -Methode verwenden möchten, um dem Steuerelement eine große Anzahl von Elementen hinzuzufügen, verwenden Sie die BeginUpdate Methoden und EndUpdate , um zu verhindern, dass die ListView neu gezeichnet wird, bis alle Elemente hinzugefügt wurden. Beim Hinzufügen von Elementen zu ist ListViewes effizienter, zuerst die Elemente zu sortieren und dann neue Elemente hinzuzufügen.
Weitere Informationen
Gilt für:
Add(String, String)
Erstellt ein Element mit dem angegebenen Text und dem Bild und fügt es der Auflistung hinzu.
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 ListViewItemParameter
- 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.
Hinweise
Wenn sortiert ListView wird, wird das Element in der ordnungsgemäß sortierten Reihenfolge hinzugefügt, andernfalls wird es am Ende der Auflistung hinzugefügt.
Gilt für:
Add(String, String, Int32)
Erstellt ein Element mit dem angegebenen Schlüssel, dem Text und dem Bild und fügt der Auflistung ein Element hinzu.
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 ListViewItemParameter
- key
- String
Name des Elements.
- 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
Die enthaltende ListView befindet sich im virtuellen Modus.
Hinweise
Wenn sortiert ListView wird, wird das Element in der ordnungsgemäß sortierten Reihenfolge hinzugefügt, andernfalls wird es am Ende der Auflistung hinzugefügt. Die Name -Eigenschaft entspricht dem Schlüssel für ein ListViewItem in der ListView.ListViewItemCollection.
Die Add -Methode legt die Name -Eigenschaft auf den angegebenen Schlüssel fest, sodass das Element nach seinem Index oder schlüssel abgerufen werden kann.
Gilt für:
Add(String, String, String)
Erstellt ein Element mit dem angegebenen Schlüssel, Text und Bild und fügt es der Auflistung hinzu.
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 ListViewItemParameter
- key
- String
Name des Elements.
- 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.
Hinweise
Die Name -Eigenschaft entspricht dem Schlüssel für ein ListViewItem in der ListView.ListViewItemCollection.
Wenn sortiert ListView wird, wird das Element in der ordnungsgemäß sortierten Reihenfolge hinzugefügt, andernfalls wird es am Ende der Auflistung hinzugefügt. Die Add -Methode legt die Name -Eigenschaft des Elements auf den angegebenen Schlüssel fest, sodass das Element anhand seines Indexes oder anhand des Schlüssels abgerufen werden kann.
