Teilen über


ListViewItem.ListViewSubItemCollection.AddRange Methode

Definition

Fügt der Auflistung ein Array von Unterelementen hinzu.

Überlädt

AddRange(String[])

Erstellt neue Unterelemente auf der Grundlage eines Arrays und fügt diese der Auflistung hinzu.

AddRange(ListViewItem+ListViewSubItem[])

Fügt der Auflistung ein Array von ListViewItem.ListViewSubItem-Objekten hinzu.

AddRange(String[], Color, Color, Font)

Erstellt neue Unterelemente auf der Grundlage eines Arrays und fügt diese mit der angegebenen Vorder- und Hintergrundfarbe sowie Schriftart der Auflistung hinzu.

AddRange(String[])

Erstellt neue Unterelemente auf der Grundlage eines Arrays und fügt diese der Auflistung hinzu.

public:
 void AddRange(cli::array <System::String ^> ^ items);
public:
 void AddRange(... cli::array <System::String ^> ^ items);
public void AddRange (string[] items);
public void AddRange (params string[] items);
member this.AddRange : string[] -> unit
Public Sub AddRange (items As String())
Public Sub AddRange (ParamArray items As String())

Parameter

items
String[]

Ein Array von Zeichenfolgen, die den Text der einzelnen Unterelemente darstellen, die der Auflistung hinzugefügt werden sollen.

Hinweise

Sie können diese Version der AddRange Methode verwenden, um der Auflistung ein Array von Zeichenfolgen hinzuzufügen, wobei jede Zeichenfolge in der Auflistung den Text eines neuen Unterelements darstellt. Sie können die andere Version der -Methode verwenden, die AddRange ein Array von Zeichenfolgen als Parameter akzeptiert, um die Vordergrundfarbe, Hintergrundfarbe und Schriftart für jedes hinzugefügte Element anzugeben. Wenn Sie vorhandene Objekte wiederverwenden ListViewItem.ListViewSubItem und der Auflistung hinzufügen möchten, können Sie die Version der Methode verwenden, die AddRange ein Array von ListViewItem.ListViewSubItem Objekten als Parameter akzeptiert.

Wenn Sie eine einzelne ListViewItem.ListViewSubItemhinzufügen möchten, verwenden Sie die Add -Methode. Sie können die Insert -Methode auch verwenden, wenn Sie eine Einzelne ListViewItem.ListViewSubItem an einer bestimmten Position in der Auflistung hinzufügen möchten.

Weitere Informationen

Gilt für:

AddRange(ListViewItem+ListViewSubItem[])

Fügt der Auflistung ein Array von ListViewItem.ListViewSubItem-Objekten hinzu.

public:
 void AddRange(cli::array <System::Windows::Forms::ListViewItem::ListViewSubItem ^> ^ items);
public:
 void AddRange(... cli::array <System::Windows::Forms::ListViewItem::ListViewSubItem ^> ^ items);
public void AddRange (System.Windows.Forms.ListViewItem.ListViewSubItem[] items);
public void AddRange (params System.Windows.Forms.ListViewItem.ListViewSubItem[] items);
member this.AddRange : System.Windows.Forms.ListViewItem.ListViewSubItem[] -> unit
Public Sub AddRange (items As ListViewItem.ListViewSubItem())
Public Sub AddRange (ParamArray items As ListViewItem.ListViewSubItem())

Parameter

items
ListViewItem.ListViewSubItem[]

Ein Array von ListViewItem.ListViewSubItem-Objekten, die der Auflistung hinzugefügt werden sollen.

Hinweise

Sie können diese Methode verwenden, um die Unterelemente wiederzuverwenden, die in einem anderen ListViewItemgespeichert sind. Wenn Sie ein einzelnes ListViewItem.ListViewSubItem Objekt hinzufügen möchten, verwenden Sie die Add -Methode. Sie können die Insert -Methode auch verwenden, wenn Sie eine Einzelne ListViewItem.ListViewSubItem an einer bestimmten Position in der Auflistung hinzufügen möchten.

Weitere Informationen

Gilt für:

AddRange(String[], Color, Color, Font)

Erstellt neue Unterelemente auf der Grundlage eines Arrays und fügt diese mit der angegebenen Vorder- und Hintergrundfarbe sowie Schriftart der Auflistung hinzu.

public:
 void AddRange(cli::array <System::String ^> ^ items, System::Drawing::Color foreColor, System::Drawing::Color backColor, System::Drawing::Font ^ font);
public void AddRange (string[] items, System.Drawing.Color foreColor, System.Drawing.Color backColor, System.Drawing.Font font);
member this.AddRange : string[] * System.Drawing.Color * System.Drawing.Color * System.Drawing.Font -> unit
Public Sub AddRange (items As String(), foreColor As Color, backColor As Color, font As Font)

Parameter

items
String[]

Ein Array von Zeichenfolgen, die den Text der einzelnen Unterelemente darstellen, die der Auflistung hinzugefügt werden sollen.

foreColor
Color

Eine Color, die die Vordergrundfarbe des Unterelements darstellt.

backColor
Color

Eine Color, die die Hintergrundfarbe des Unterelements darstellt.

font
Font

Ein Font, der die Schriftart darstellt, in der der Text des Unterelement angezeigt werden soll.

Hinweise

Sie können diese Version der AddRange Methode verwenden, um der Auflistung ein Array von Zeichenfolgen hinzuzufügen, wobei jede Zeichenfolge in der Auflistung den Text eines neuen Unterelements darstellt. Darüber hinaus können Sie mit dieser Version der AddRange Methode die Vordergrundfarbe, Hintergrundfarbe und Schriftart für jedes Unterelement angeben. Sie können die andere Version der Methode verwenden, die AddRange ein Array von Zeichenfolgen als Parameter akzeptiert, wenn Sie keine Vordergrundfarbe, Hintergrundfarbe und Schriftarteinstellungen für jedes Unterelement angeben möchten. Wenn Sie vorhandene Objekte wiederverwenden ListViewItem.ListViewSubItem und der Auflistung hinzufügen möchten, können Sie die Version der Methode verwenden, die AddRange ein Array von ListViewItem.ListViewSubItem Objekten als Parameter akzeptiert.

Wenn Sie eine einzelne ListViewItem.ListViewSubItemhinzufügen möchten, verwenden Sie die Add -Methode. Sie können die Insert -Methode auch verwenden, wenn Sie eine Einzelne ListViewItem.ListViewSubItem an einer bestimmten Position in der Auflistung hinzufügen möchten.

Hinweis

Standardmäßig verwenden Unterelemente die Vordergrundfarbe, Hintergrundfarbe und Schriftart, die für das übergeordnete Element angegeben sind. Legen Sie die ListViewItem.UseItemStyleForSubItems -Eigenschaft auf fest false , um zu verhindern, dass die übergeordneten Elementstile die Unterelementstile überschreiben.

Weitere Informationen

Gilt für: