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


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Initializes a new instance of the ListViewItem class with the image index position of the item's icon and an array of ListViewItem.ListViewSubItem objects, and assigns the item to the specified group.

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

public ListViewItem(
	ListViewItem.ListViewSubItem[] subItems,
	int imageIndex,
	ListViewGroup group


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

An array of type ListViewItem.ListViewSubItem that represents the subitems of the item.

Type: System.Int32

The zero-based index of the image within the ImageList associated with the ListView that contains the item.

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 object (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.


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