User Guide

About working with RecordSet objects 79
To set up a notification event for an ActionScript object, use the RecordSet
addEventListener() method and specify the object to notify when the RecordSet object
changes. You can specify any object that receives change notifications in the
addEventListener() method, as in the following example:
myRecordSet.addEventListener("modelChanged", contact_grid);
In this example, the myRecordSet object represents a record set returned from Flash Remoting,
and the
addEventListener() method tells Flash Remoting to notify the contact_grid object
whenever the theRecordSet object changes.
The object that receives the notification must include a
modelChanged callback function to
handle the notification. Whenever the RecordSet object changes, the
modelChanged function
gets called with a message object that consists of one or more entries, as follows:
• The first entry, eventName, identifies the type of event or change that was made to the record.
• For some types of events, the message object also includes entries identifying the first and last
record in the record set that were affected by the event.
The types of events that can occur and be specified in the
eventName property are addItems,
allRows, fetchRows, sort, removeItem, removeItems, and updateItems. Depending on the
value of
eventName, the following properties might provide additional information: firstItem,
lastItem, removedIDs, and removedItems. For descriptions of RecordSet events and properties,
see the RecordSet class in Flash Remoting ActionScript Dictionary Help.
The following example creates a
modelChanged function that displays a trace message with the
event type and sets it up as the callback handler for changes to the myRecordSet object:
var myObj = new Object();
myObj.modelchanged = function(info)
{
trace("Caught modelChanged event: " + info.eventName);
}
myRecordSet = new RecordSet(["DepartmentID", "DepartmentName"]);
myRecordSet.addEventListener("modelChanged", myObj);
The following example of activity on the myRecordSet RecordSet causes the modelChanged
function to display
addItems as the event name:
var newDept = {DepartmentID: "6504", DepartmentName: "Customer Relations"};
myRecordSet.addItemAt(15, newDept);
For more information on the RecordSet.addEventListener() and
RecordSet.removeEventListener() methods, see the RecordSet.addEventListener() and the
RecordSetRemoveEventListener in Flash Remoting ActionScript Dictionary Help.
Sorting and filtering record sets
The
RecordSet class has methods for sorting an existing RecordSet object or creating a new
RecordSet object from an existing one by applying a selection (filter) function.