Flash CS3 Documentation 
Flash CS3 Documentation |
|||
| ActionScript 2.0 Components Language Reference > DataSet component > DataSet.disableEvents() | |||
|
|||
|
|||
|
|||
Flash Player 7.
Flash MX Professional 2004.
dataSetInstance.disableEvents()
Nothing.
Method; disables events for the DataSet object. While events are disabled, no user interface controls (such as a DataGrid component) are updated when changes are made to items in the collection, or when the DataSet object is scrolled to another item in the collection.
To reenable events, you must call DataSet.enableEvents(). The disableEvents() method can be called multiple times, and enableEvents() must be called an equal number of times to reenable the dispatching of events.
In the following example, events are disabled before changes are made to items in the collection, so that the DataSet object won't affect performance by trying to refresh controls:
my_ds.addEventListener("modelChanged", onModelChanged);
function onModelChanged(evt_obj:Object):Void {
trace("model changed, DataSet now has " + evt_obj.target.items.length + " items");
}
// Disable events for the data set.
my_ds.disableEvents();
my_ds.addItem({name:"Apples", price:14});
my_ds.addItem({name:"Bananas", price:8});
trace("Before:");
traceItems();
my_ds.last();
while(my_ds.hasPrevious()) {
my_ds.price *= 0.5; // Everything's 50% off!
my_ds.previous();
}
trace("After:");
traceItems();
// Tell the dataset it's time to update the controls now.
my_ds.enableEvents();
function traceItems():Void {
for (var i:Number = 0; i < my_ds.items.length; i++) {
trace("\t" + my_ds.items[i].name + " - $" + my_ds.items[i].price);
}
trace("");
}
Flash CS3