←Select platform

Sorting Property (RasterImageList)

Summary

Gets or sets the sort order for items in the control.

Syntax

C++

[CategoryAttribute("Behavior")] 
[DescriptionAttribute("Indicates the manner in which items are to be sorted.")] 
public SortOrder Sorting {get; set;}

<CategoryAttribute("Behavior")> 
<DescriptionAttribute("Indicates the manner in which items are to be sorted.")> 
Public Property Sorting As SortOrder

[CategoryAttribute("Behavior")] 
[DescriptionAttribute("Indicates the manner in which items are to be sorted.")] 
public: 
property SortOrder Sorting { 
   SortOrder get(); 
   void set (    SortOrder ); 
}

Property Value

One of the SortOrder values. The default is SortOrder.None.

Remarks

The Sorting property allows you to specify whether or not items are sorted in the RasterImageList control. By default, no sorting is performed. When the Sorting property is set to SortOrder.Ascending or SortOrder.Descending, the items in the RasterImageList are sorted automatically in ascending alphabetical order (when the property is set to SortOrder.Ascending) or descending alphabetical order (when the property is set to SortOrder.Descending). You can use this property to automatically sort items that are displayed in your RasterImageList control to make it easier for users to find items when a large number of items are available. By default items are sorted alphabetically according to the Text property of each item.

After you change the Sorting property, call the Sort method to re-sort the items in the control.

The Sorting property is dependent on the value of the Sorter property.

You can setup your own sorting by providing a custom System.Collections.IComparer object using the Sorter property.

Example

For an example, refer to Sort.

Requirements

Target Platforms

See Also