User Guide
DataSet component (Flash Professional only) 323
Conversion of the data specified is based on the underlying field’s type. For example, if the search
value specified is
["05-02-02"], the underlying date field is used to convert the value with the
date’s
setAsString() method. If the value specified is [new Date().getTime()], the date’s
setAsNumber() method is used.
Example
This example searches for the last item in the current collection whose name and age fields
contain
"Bobby" and "13". If found, DataSet.getItemId() is used to get the unique identifier
for the item in the collection, and
DataSet.locateById() is used to position the current iterator
on that item.
var studentID:String = null;
studentData.addSort("nameAndAge", ["name", "age"]);
// Locate the last transfer object with the specified values.
// Note that the order of the search fields matches those
// specified in addSort().
if(studentData.findLast(["Bobby", "13"])) {
studentID = studentData.getItemId();
}
// Now use locateByID() to position the current iterator
// on the item in the collection whose ID matches studentID.
if(studentID != null) {
studentData.locateById(studentID);
}
See also
DataSet.applyUpdates()
, DataSet.getItemId(), DataSet.locateById()
DataSet.first()
Availability
Flash Player 7.
Edition
Flash MX Professional 2004.
Usage
dataSet.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.