ThumbnailListView Class

Syntax

Public Class ThumbnailListView _
	Inherits VirtualListView

public class ThumbnailListView : VirtualListView

Remarks

ThumbnailListView control allows you to display list of items with text and an image to identify the type of item. The identifying icon depends on the control's current view mode and can be small icon, large icon or an item thumbnail. Small icons are displayed in the Icons and Details modes, large icons are displayed in the Icons mode and thumbnails - in Thumbnails mode. Appearance of the control is very similar to the Windows Explorer list of files, so users will have well-known interface.

The single list item is represented by an object which implements the IListItem interface. Graphics Mill for .NET has a ThumbnailListItem class which represents an implementation of this interface based on shell objects. Shell objects are represented by the Pidl class. They include a file system objects and some extra items such as special folder (Desktop, My Pictures, etc), USB storage devices, digital cameras, etc.

You can also implement this interface yourself. This way you can display items from a database, etc.

To get access to list items, use the Items property. If you need to get items which are selected, you can use SelectedIndices or SelectedItems property. In the same way you can get checked items: just use CheckedIndices or CheckedItems property.

The control exposes a large number of properties which allow you to change its behavior and appearance. E.g. possibility to display check boxes for each item (CheckBoxes), multiple items selection (MultiSelect), drag-n-drop support, editable labels of items (LabelEdit), etc.

When you are using Details view mode, you should set up columns using the Columns property. You should fill it with instances of the ListColumn class which identify what columns should be visible and what piece of data to display.

When you work with Details view, you can use a number of handy properties. E.g. the AllowColumnReorder property allows the user of your ThumbnailListView control to reconfigure the order of columns at run time. The FullRowSelect property allows an item and its subitems to be selected instead of just the item. To display grid lines in the details view to identify the boundaries of items and subitems in the control, you can use the Gridlines property. The HeaderStyle property allows you to specify the type of column headers to display.

Inheritance Hierarchy

Thread Safety

Object Model

See Also

Reference

• ThumbnailListView Members
• Aurigma.GraphicsMill.WinControls Namespace