How to: Display Icons for the Windows Forms ListView Control

Article
04/23/2007

The Windows Forms ListView control can display icons from three image lists. The List, Details, and SmallIcon views display images from the image list specified in the SmallImageList property. The LargeIcon view displays images from the image list specified in the LargeImageList property. A list view can also display an additional set of icons, set in the StateImageList property, next to the large or small icons. For more information about image lists, see ImageList Component (Windows Forms) and How to: Add or Remove Images with the Windows Forms ImageList Component.

To display images in a list view

Set the appropriate property—SmallImageList, LargeImageList, or StateImageList—to the existing ImageList component you wish to use.

These properties can be set in the designer with the Properties window, or in code.
```
ListView1.SmallImageList = ImageList1
```
```
listView1.SmallImageList = imageList1;
```
```
listView1.set_SmallImageList(imageList1);
```
Set the ImageIndex or StateImageIndex property for each list item that has an associated icon.

These properties can be set in code, or within the ListViewItem Collection Editor. To open the ListViewItem Collection Editor, click the ellipsis button () next to the Items property on the Properties window.
```
' Sets the first list item to display the 4th image.
ListView1.Items(0).ImageIndex = 3
```
```
// Sets the first list item to display the 4th image.
listView1.Items[0].ImageIndex = 3;
```
```
// Sets the first list item to display the 4th image.
listView1.get_Items().get_Item(0).set_ImageIndex(3);
```

See Also

Tasks

How to: Add and Remove Items with the Windows Forms ListView Control
How to: Add Columns to the Windows Forms ListView Control
How to: Add Custom Information to a TreeView or ListView Control (Windows Forms)

Reference

ListView Control Overview (Windows Forms)

Other Resources

ImageList Component (Windows Forms)