ListViewItem Constructor (ListViewItem.ListViewSubItem[], String, ListViewGroup)

 

Initializes a new instance of the ListViewItem class with the specified subitems, image, and group.

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

public ListViewItem(
	ListViewItem.ListViewSubItem[] subItems,
	string imageKey,
	ListViewGroup group
)

Parameters

subItems
Type: System.Windows.Forms.ListViewItem.ListViewSubItem[]

An array of ListViewItem.ListViewSubItem objects that represent the subitems of the ListViewItem.

imageKey
Type: System.String

The name of the image within the ImageList of the owning ListView to display in the item.

group
Type: System.Windows.Forms.ListViewGroup

The ListViewGroup to assign the item to.

This version of the constructor is useful when you create ListViewItem.ListViewSubItem objects before adding them to a ListViewItem (for example, to indicate special formatting or to use the subitems in multiple items). It also allows you to specify the group to which an item belongs.

The imageKey parameter specifies an image in the ImageList associated with the owning ListView control, which can be accessed with the ImageList property.

System_CAPS_noteNote

ListView groups are only available on Windows XP and the Windows Server 2003 family (Windows XP Home Edition, Windows XP Professional, Windows Server 2003). For more information, see the ListViewGroup overview topic.

.NET Framework
Available since 2.0
Return to top
Show: