ListViewItem.ListViewSubItemCollection.AddRange Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Adds an array of subitems to the collection.
Overloads
AddRange(String[]) |
Creates new subitems based on an array and adds them to the collection. |
AddRange(ListViewItem+ListViewSubItem[]) |
Adds an array of ListViewItem.ListViewSubItem objects to the collection. |
AddRange(String[], Color, Color, Font) |
Creates new subitems based on an array and adds them to the collection with specified foreground color, background color, and font. |
AddRange(String[])
Creates new subitems based on an array and adds them to the collection.
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())
Parameters
- items
- String[]
An array of strings representing the text of each subitem to add to the collection.
Remarks
You can use this version of the AddRange method to add an array of strings to the collection, where each string in the collection represents the text of a new subitem. You can use the other version of the AddRange method that accepts an array of strings as a parameter to specify the foreground color, background color, and font for each item being added. If you want to reuse existing ListViewItem.ListViewSubItem objects and add them to the collection, you can use the version of the AddRange method that accepts an array of ListViewItem.ListViewSubItem objects as a parameter.
If you want to add a single ListViewItem.ListViewSubItem, use the Add method. You can also use the Insert method if you want to add a single ListViewItem.ListViewSubItem at a specific position in the collection.
See also
Applies to
AddRange(ListViewItem+ListViewSubItem[])
Adds an array of ListViewItem.ListViewSubItem objects to the collection.
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())
Parameters
- items
- ListViewItem.ListViewSubItem[]
An array of ListViewItem.ListViewSubItem objects to add to the collection.
Remarks
You can use this method to reuse the subitems stored in a different ListViewItem. If you want to add a single ListViewItem.ListViewSubItem object, use the Add method. You can also use the Insert method if you want to add a single ListViewItem.ListViewSubItem at a specific position in the collection.
See also
- Add(ListViewItem+ListViewSubItem)
- Insert(Int32, ListViewItem+ListViewSubItem)
- ListViewItem.ListViewSubItem
Applies to
AddRange(String[], Color, Color, Font)
Creates new subitems based on an array and adds them to the collection with specified foreground color, background color, and font.
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)
Parameters
- items
- String[]
An array of strings representing the text of each subitem to add to the collection.
Remarks
You can use this version of the AddRange method to add an array of strings to the collection, where each string in the collection represents the text of a new subitem. In addition, this version of the AddRange method allows you to specify the foreground color, background color, and font for each subitem. You can use the other version of the AddRange method that accepts an array of strings as a parameter if you do not want to specify foreground color, background color, and font settings for each subitem. If you want to reuse existing ListViewItem.ListViewSubItem objects and add them to the collection, you can use the version of the AddRange method that accepts an array of ListViewItem.ListViewSubItem objects as a parameter.
If you want to add a single ListViewItem.ListViewSubItem, use the Add method. You can also use the Insert method if you want to add a single ListViewItem.ListViewSubItem at a specific position in the collection.
Note
By default, subitems use the foreground color, background color, and font specified for the parent item. Set the ListViewItem.UseItemStyleForSubItems property to false
to prevent the parent item styles from overriding the subitem styles.