ListView::ListViewItemCollection::Add Method (String^, String^, String^)

 

Creates an item with the specified key, text, and image, and adds it to the collection.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public:
virtual ListViewItem^ Add(
	String^ key,
	String^ text,
	String^ imageKey
)

Parameters

key
Type: System::String^

The name of the item.

text
Type: System::String^

The text of the item.

imageKey
Type: System::String^

The key of the image to display for the item.

Return Value

Type: System.Windows.Forms::ListViewItem^

The ListViewItem added to the collection.

The Name property corresponds to the key for a ListViewItem in the ListView::ListViewItemCollection.

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 Add method sets the Name property of the item to the specified key, so the item can be retrieved by its index or by key.

.NET Framework
Available since 2.0
Return to top
Show: