User Guide

List.vPosition 809

Description

Method; sorts the items in the list in the specified order, using the specified field name. If the

fieldName items are a combination of text strings and integers, the integer items are listed

first. The

fieldName parameter is usually "label" or "data", but you can specify any

primitive data value.

This is the fastest way to sort data in a component. It also maintains the component’s

selection state. The

sortItemsBy() method is fast because it doesn’t run any ActionScript

while sorting. The

sortItems() method needs to run an ActionScript compare function, and

is therefore slower.

Example

The following code sorts the items in the list in ascending order using the labels of the list

items:

var my_list:mx.controls.List;

my_list.setSize(200, 100);

my_list.addItem({data:"flash", label:"Flash"});

my_list.addItem({data:"dreamweaver", label:"Dreamweaver"});

my_list.addItem({data:"coldfusion", label:"ColdFusion"});

my_list.sortItemsBy("label", "ASC");