ListView::ListViewItemCollection::Add Method (String^, String^, Int32)
.NET Framework (current version)
Creates an item with the specified key, text, and image and adds an item to the collection.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
Parameters
- key
-
Type:
System::String^
The name of the item.
- text
-
Type:
System::String^
The text of the item.
- imageIndex
-
Type:
System::Int32
The index of the image to display for the item.
| Exception | Condition |
|---|---|
| InvalidOperationException | The containing ListView is in virtual mode. |
If the ListView is sorted, the item is added in the correctly sorted order; otherwise, it is added to the end of the collection. The Name property corresponds to the key for a ListViewItem in the ListView::ListViewItemCollection.
The Add method sets the Name property to the specified key, so the item can be retrieved by its index or by key.
.NET Framework
Available since 2.0
Available since 2.0
Show: