Sorted (Property)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage properties / Properties associated with windows, pages and controls

Limitations

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Properties associated with windows, pages and controls

Sorted (Property)

In french: Triée

The Sorted property is used to:

Determine if a control is sorted.
Sort a control.

This property is used to:

determine if List Box and Combo Box controls populated programmatically are sorted.
determine if Image, Clickable Image, and Thumbnail controls with an automatic sequence are sorted.
sort Image, Clickable Image, and Thumbnail controls that have an automatic sequence.

Remarks:

The Sorted property sorts the elements in the List Box or Combo Box control when it is displayed. If the control is sorted, new elements will be inserted (ListAdd) according to the current order.
For ListView controls, the sort order is defined according to the caption of the elements.
This option can be chosen in the window or page editor in the control description ("Details" tab, "Sorted list" option).

Example

ListAdd(LIST_List1, "CC")
ListAdd(LIST_List1, "DD")
ListAdd(LIST_List1, "BB")
LIST_List1.Sorted = True
// The order in the List Box control becomes BB, CC, DD
ListAdd(LIST_List1, "AA") // Will be inserted at the beginning of the list

Syntax

Determining if a control is sorted Hide the details

<Result> = <Control used>.Sorted

<Result>: Boolean

True if the specified control is sorted,
False otherwise.

<Control used>: Control name

Name of the control to be used:
Name of the List Box or ListView control.
Name of the Combo Box control.
Name of the Image, Clickable Image or Thumbnail control with an automatic sequence.

Sorting a control Hide the details

<Control used>.Sorted = <To sort>

<Control used>: Control name

Name of the control to sort:
Name of the Image, Clickable Image or Thumbnail control with an automatic sequence.

<To sort>: Boolean

True if the specified control must be sorted,
False otherwise.

Remarks

Limitations

The Sorted property applies only to:

List Box and Combo Box controls populated programmatically.
Image, Clickable Image or Thumbnail controls with an automatic sequence.