A newer version of this page is available. Switch to the current version.

TreeList.SelectImageList Property

Gets or sets the source of select images for nodes.

Namespace: DevExpress.XtraTreeList

Assembly: DevExpress.XtraTreeList.v19.1.dll

Declaration

[DefaultValue(null)]
public object SelectImageList { get; set; }

Property Value

Type Default Description
Object

null

An object which represents the source of select images.

Remarks

Nodes can display two images simultaneously. These are called select and state images.

veNodeImage

Use the SelectImageList property to specify the source of select images. Certain select images are assigned to nodes by indexes (zero-based integer values referring to images in the SelectImageList).

Select image indexes can be specified in a number of ways:

  1. The TreeList.ImageIndexFieldName property. Use this property if image indexes are stored in a data source.
  2. The TreeListNode.ImageIndex and TreeListNode.SelectImageIndex properties.

    The TreeListNode.ImageIndex property specifies the select image for a node, when it is not focused. When the node is focused, this image is automatically replaced with the image specified by the TreeListNode.SelectImageIndex property.

    When using the TreeList.ImageIndexFieldName, TreeListNode.ImageIndex and TreeListNode.SelectImageIndex simultaneously, the latter two properties are in effect if an image index retrieved from a data source is -1.

  3. The TreeList.GetSelectImage event - Provides the most flexible approach to provide select images to nodes.

The SelectImageList property accepts the following image collections:

A click on a node’s select image fires the TreeList.SelectImageClick event.

See Also