ListViewItem::ListViewSubItemCollection::AddRange Method (array<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.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
public: void AddRange( array<String^>^ items, Color foreColor, Color backColor, Font^ font )
Parameters
- items
-
Type:
array<System::String^>^
An array of strings representing the text of each subitem to add to the collection.
- foreColor
-
Type:
System.Drawing::Color
A Color that represents the foreground color of the subitem.
- backColor
-
Type:
System.Drawing::Color
A Color that represents the background color of the subitem.
- font
-
Type:
System.Drawing::Font^
A Font that represents the typeface to display the subitem's text in.
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. |
Available since 1.1
