User Guide

DataGrid component (Flash Professional only) 265
trace("The cell at " + cell + " has lost focus");
};
grid.addEventListener("cellFocusOut", myListener);
Note: The grid must be editable for the above code to work.
DataGrid.cellPress
Availability
Flash Player 6 (6.0 79.0).
Edition
Flash MX Professional 2004.
Usage
listenerObject = new Object();
listenerObject.cellPress = function(eventObject){
// insert your code here
}
myDataGridInstance.addEventListener("cellPress", listenerObject)
Description
Event; broadcast to all registered listeners when a user presses the mouse button on a cell.
Version 2 components use a dispatcher/listener event model. When a DataGrid component
broadcasts a
cellPress event, the event is handled by a function (also called a handler) that is
attached to a listener object (
listenerObject) that you create. You call the
addEventListener() method and pass it the name of the handler as a parameter.
When the event is triggered, it automatically passes an event object (
eventObject) to the
handler. Each event object has properties that contain information about the event. You can use
these properties to write code that handles the event. The
DataGrid.cellPress event’s event
object has three additional properties:
columnIndex A number that indicates the index of the column that was pressed. The first
position is 0.
itemIndex A number that indicates the index of the row that was pressed. The first position is
0.
type The string "cellPress".
For more information, see “EventDispatcher class” on page 415.
Example
In the following example, a handler called myListener is defined and passed to
grid.addEventListener() as the second parameter. The event object is captured by the
cellPress handler in the eventObject parameter. When the cellPress event is broadcast, a
trace statement is sent to the Output panel.
var myListener = new Object();
myListener.cellPress = function(event) {
var cell = "(" + event.columnIndex + ", " + event.itemIndex + ")";