DataSet.enableEvents()

Availability

Flash Player 7.

Edition

Flash MX Professional 2004.

Usage

dataSetInstance.enableEvents()

Returns

Nothing.

Description

Method; reenables events for the DataSet objects after events have been disabled by a call to DataSet.disableEvents(). To reenable events for the DataSet object, the enableEvents() method must be called an equal or greater number of times than disableEvents() was called.

Example

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 data set 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("");
}

See also

DataSet.disableEvents()


Flash CS3