Sort

Sorts rows in a DataWindow control, DataStore, or child DataWindow, or items in a TreeView or ListView control.

For syntax for DataWindows and DataStores, see the Sort method for DataWindows in the section called “Sort” in DataWindow Reference.

To sort

Use

Items in a TreeView

Syntax 1

Items in a ListView

Syntax 2


Syntax 1: For TreeView controls

Description

Sorts the children of an item in a TreeView control.

Applies to

TreeView controls

Syntax

treeviewname.Sort ( itemhandle , sorttype )

Argument

Description

treeviewname

The name of the TreeView control in which you want to sort items.

itemhandle

The item for which you want to sort its children.

sorttype

The sort method you want to use. Valid values are:

Ascending!

Descending!

UserDefinedSort!


Return value

Integer.

Returns 1 if it succeeds and -1 if it fails.

Usage

The Sort function only sorts the immediate level beneath the specified item. If you want to sort multiple levels, use SortAll. If you specify UserDefinedSort! as your sorttype, define your sort criteria in the Sort event of the TreeView control. To sort level 1 of a TreeView, set itemhandle to 0.

Examples

This example sorts the children of the current TreeView item:

long ll_tvi
ll_tvi = tv_foo.FindItem(CurrentTreeItem! , 0)
tv_foo.SetRedraw(false)
tv_foo.Sort(ll_tvi , Ascending!)
tv_foo.SetRedraw(true)

See also

SortAll

Syntax 2: For ListView controls

Description

Sorts items in ListView controls.

Applies to

ListView controls

Syntax

listviewname.Sort ( sorttype, { column } )

Argument

Description

listviewname

The ListView in which you want to sort items.

sorttype

The method you want to use when you sort the ListView items. Values are:

Ascending!

Descending!

Unsorted!

UserDefinedSort!

column (optional)

The number of the column by which you wish to sort the ListView items.


Return value

Integer.

Returns 1 if it succeeds and -1 if it fails.

Usage

The default sort is alphanumeric.

If you do not specify a column to sort, the first column is sorted.

Examples

This example sorts the items in column three of a ListView:

lv_list.SetRedraw(false)
lv_list.Sort(Ascending! , 3)
lv_list.SetRedraw(true)

See also

SortAll