Flash CS3 Documentation

ActionScript 2.0 Components Language Reference > DataSet component > DataSet.first()

DataSet.first()

Availability

Flash Player 7.

Edition

Flash MX Professional 2004.

Usage

dataSetInstance.first()

Returns

Nothing.

Description

Method; makes the first item in the current view of the collection the current item. Which items are in the current view depends on any current filter and range settings.

Example

The following code positions the data set inventory_ds at the first item in its collection, and then displays the value of the price property contained by that item using the DataSet.currentItem property.

inventory_ds.first();
trace("The price of the first item is:" + inventory_ds.currentItem.price);

The following example iterates over all of the items in the current view of the collection (starting at its beginning) and performs a calculation on the price property of each item.

my_ds.addItem({name:"item a", price:16});
my_ds.addItem({name:"item b", price:9});

my_ds.first();
while (my_ds.hasNext()) {
    my_ds.currentItem.price *= 0.5; // Everything's 50% off!
    my_ds.next();
}

for (var i in my_ds.items) {
    trace(my_ds.items[i].name + ": " + my_ds.items[i].price);
}