      * 
      *  @return true if the editor session was started. Returns false if
      *  the editor session was cancelled.
+     * 
+     *  @langversion 3.0
+     *  @playerversion Flash 10
+     *  @playerversion AIR 2.0
+     *  @productversion Flex 4.5
+     *  
      */ 
     public function startItemEditorSession(rowIndex:int, columnIndex:int):Boolean
     {

    //----------------------------------
    //  editorLayer
    //----------------------------------
    
    [SkinPart(required="false", type="mx.core.IVisualElementContainer")]
    
    /**
     *  @private
     *  
     *  Where item editors are added to the data grid.
     */
    public var itemEditorLayer:IVisualElementContainer;
    

[Event(name="caretChange", type="spark.events.GridCaretEvent")]

//--------------------------------------
//  Edit Events
//--------------------------------------

/**
 *  Dispatched when a new item editor session has been requested. A listener can
 *  dynamically determine if a cell is editable and cancel the edit (with 
 *  preventDefault()) if it is not. A listener may also dynamically 
 *  change the editor that will be used by assigning a different item editor to
 *  a column.
 * 
 *  <p>If this event is cancelled the item editor will not be created.</p>
 *
 *  @eventType spark.events.DataGridEditEvent.START_GRID_ITEM_EDITOR_SESSION
 *  
 *  @see spark.components.DataGrid.itemEditorInstance
 *  @see flash.events.Event
 * 
 *  @langversion 3.0
 *  @playerversion Flash 10
 *  @playerversion AIR 2.0
 *  @productversion Flex 4.5
 */
[Event(name="startGridItemEditorSession", type="spark.events.DataGridEditEvent")]

/**
 *  Dispatched immediately after an item editor has been opened. 
 *
 *  @eventType spark.events.DataGridEditEvent.OPEN_GRID_ITEM_EDITOR_SESSION
 *  
 *  @see spark.components.DataGrid.itemEditorInstance
 * 
 *  @langversion 3.0
 *  @playerversion Flash 10
 *  @playerversion AIR 2.0
 *  @productversion Flex 4.5
 */
[Event(name="openGridItemEditorSession", type="spark.events.DataGridEditEvent")]

/**
 *  Dispatched after the data in item editor has been saved into the data provider
 *  and the editor has been closed.  
 *
 *  @eventType spark.events.DataGridEditEvent.SAVE_GRID_ITEM_EDITOR_SESSION
 *  
 *  @see spark.components.DataGrid.itemEditorInstance
 *  
 *  @langversion 3.0
 *  @playerversion Flash 10
 *  @playerversion AIR 2.0
 *  @productversion Flex 4.5
 */
[Event(name="saveGridItemEditorSession", type="spark.events.DataGridEditEvent")]

/**
 *  Dispatched after the item editor has been closed without saving its data.  
 *
 *  @eventType spark.events.DataGridEditEvent.CANCEL_GRID_ITEM_EDITOR_SESSION
 *  
 *  @see spark.components.DataGrid.itemEditorInstance
 *  
 *  @langversion 3.0
 *  @playerversion Flash 10
 *  @playerversion AIR 2.0
 *  @productversion Flex 4.5
 */
[Event(name="cancelGridItemEditorSession", type="spark.events.DataGridEditEvent")]

//--------------------------------------
//  Other metadata
//--------------------------------------

