Главная / Action Script 3
Пакетfl.events
Классpublic class DataGridEvent
НаследованиеDataGridEvent Inheritance ListEvent Inheritance Event Inheritance Object

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Класс DataGridEvent определяет события, связанные с компонентом DataGrid. В том числе включены указанные ниже события.

Посмотреть примеры

См. также

fl.controls.DataGrid
DataGridEventReason


Общедоступные свойства
 СвойствоОпределено
 Inheritedbubbles : Boolean
[только для чтения] Определяет, является ли событие "событием на цепочке".
Event
 Inheritedcancelable : Boolean
[только для чтения] Определяет, можно ли отключить поведение, связанное с событием.
Event
 InheritedcolumnIndex : int
[только для чтения] Определяет индекс столбца для элемента, связанного с этим событием.
ListEvent
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
 InheritedcurrentTarget : Object
[только для чтения] Объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
Event
  dataField : String
Определяет или задает имя поля или свойства в данных, связанных со столбцом.
DataGridEvent
 InheritedeventPhase : uint
[только для чтения] Текущая фаза в потоке событий.
Event
 Inheritedindex : int
[только для чтения] Определяет индекс (начиная с нуля) ячейки, содержащей средство визуализации.
ListEvent
 Inheriteditem : Object
[только для чтения] Определяет данные, принадлежащие текущему средству визуализации ячейки.
ListEvent
  itemRenderer : Object
[только для чтения] Определяет средство визуализации того редактируемого элемента или заголовка, который был щелкнут или размер которого был изменен.
DataGridEvent
 Inheritedprototype : Object
[статические] Ссылка на модель объекта класса или функции.
Object
  reason : String
[только для чтения] Определяет причину отправки события itemEditEnd.
DataGridEvent
 InheritedrowIndex : Object
[только для чтения] Определяет индекс строки для элемента, связанного с этим событием.
ListEvent
 Inheritedtarget : Object
[только для чтения] Целевой объект события.
Event
 Inheritedtype : String
[только для чтения] Тип события.
Event
Общедоступные методы
 МетодОпределено
  
DataGridEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, columnIndex:int = -1, rowIndex:int = -1, itemRenderer:Object = null, dataField:String = null, reason:String = null)
Создает новый объект DataGridEvent с заданными параметрами.
DataGridEvent
  
Создает копию объекта DataGridEvent и задает значение каждого свойства, совпадающее с оригиналом.
DataGridEvent
 Inherited
formatToString(className:String, ... arguments):String
Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event.
Event
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Проверяет, выполнялся ли для события вызова метода preventDefault().
Event
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Отменяет поведение по умолчанию для события, если такое поведение можно отменить.
Event
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом.
Event
 Inherited
Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом.
Event
  
Возвращает строку, содержащую все свойства объекта DataGridEvent.
DataGridEvent
 Inherited
Возвращает элементарное значение заданного объекта.
Object
Общедоступные константы
 Константа Определено
 InheritedACTIVATE : String = "activate"
[статические] Константа Event.ACTIVATE определяет значение свойства type объекта события Activitate.
Event
 InheritedADDED : String = "added"
[статические] Константа Event.ADDED определяет значение свойства type добавленного объекта события.
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[статические] Константа Event.ADDED_TO_STAGE определяет значение свойства type объекта события addedToStage.
Event
 InheritedCANCEL : String = "cancel"
[статические] Константа Event.CANCEL определяет значение свойства type объекта события cancel.
Event
 InheritedCHANGE : String = "change"
[статические] Константа Event.CHANGE определяет значение свойства type объекта события change.
Event
 InheritedCLEAR : String = "clear"
[статические] Задает значение свойства type для объекта события clear.
Event
 InheritedCLOSE : String = "close"
[статические] Константа Event.CLOSE определяет значение свойства type объекта события close.
Event
 InheritedAIR-only CLOSING : String = "closing"
[статические] Константа Event.CLOSING определяет значение свойства type объекта события closing.
Event
  COLUMN_STRETCH : String = "columnStretch"
[статические] Константа DataGridEvent.COLUMN_STRETCH определяет значение свойства type объекта события columnStretch.
DataGridEvent
 InheritedCOMPLETE : String = "complete"
[статические] Константа Event.COMPLETE определяет значение свойства type объекта события complete.
Event
 InheritedCONNECT : String = "connect"
[статические] Константа Event.CONNECT определяет значение свойства type объекта события connect.
Event
 InheritedCOPY : String = "copy"
[статические] Задает значение свойства type для объекта события copy.
Event
 InheritedCUT : String = "cut"
[статические] Задает значение свойства type для объекта события cut.
Event
 InheritedDEACTIVATE : String = "deactivate"
[статические] Константа Event.DEACTIVATE определяет значение свойства type объекта события deactivate.
Event
 InheritedDISPLAYING : String = "displaying"
[статические] Задает значение свойства type для объекта события displaying.
Event
 InheritedENTER_FRAME : String = "enterFrame"
[статические] Константа Event.ENTER_FRAME определяет значение свойства type объекта события enterFrame.
Event
 InheritedEXIT_FRAME : String = "exitFrame"
[статические] Определяет значение свойства type объекта exitFrame.
Event
 InheritedAIR-only EXITING : String = "exiting"
[статические] Константа Event.EXITING определяет значение свойства type объекта exiting.
Event
 InheritedFRAME_CONSTRUCTED : String = "frameConstructed"
[статические] Задает значение свойства type для объекта события frameConstructed.
Event
 InheritedFULLSCREEN : String = "fullScreen"
[статические] Константа Event.FULL_SCREEN определяет значение свойства type для объекта события fullScreen.
Event
  HEADER_RELEASE : String = "headerRelease"
[статические] Константа DataGridEvent.HEADER_RELEASE определяет значение свойства type объекта события headerRelease.
DataGridEvent
 InheritedAIR-only HTML_BOUNDS_CHANGE : String = "htmlBoundsChange"
[статические] Константа Event.HTML_BOUNDS_CHANGE определяет значение свойства type объекта htmlBoundsChange.
Event
 InheritedAIR-only HTML_DOM_INITIALIZE : String = "htmlDOMInitialize"
[статические] Константа Event.HTML_DOM_INITIALIZE определяет значение свойства type объекта события htmlDOMInitialize.
Event
 InheritedAIR-only HTML_RENDER : String = "htmlRender"
[статические] Константа Event.HTML_RENDER определяет значение свойства type объекта события htmlRender.
Event
 InheritedID3 : String = "id3"
[статические] Константа Event.ID3 определяет значение свойства type объекта id3.
Event
 InheritedINIT : String = "init"
[статические] Константа Event.INIT определяет значение свойства type объекта init.
Event
 InheritedITEM_CLICK : String = "itemClick"
[статические] Задает значение свойства type для объекта события itemClick.
ListEvent
 InheritedITEM_DOUBLE_CLICK : String = "itemDoubleClick"
[статические] Задает значение свойства type для объекта события itemDoubleClick.
ListEvent
  ITEM_EDIT_BEGIN : String = "itemEditBegin"
[статические] Константа DataGridEvent.ITEM_EDIT_BEGIN определяет значение свойства type объекта события itemEditBegin.
DataGridEvent
  ITEM_EDIT_BEGINNING : String = "itemEditBeginning"
[статические] Константа DataGridEvent.ITEM__EDIT_BEGINNING определяет значение свойства type объекта события itemEditBeginning.
DataGridEvent
  ITEM_EDIT_END : String = "itemEditEnd"
[статические] Константа DataGridEvent.ITEM_EDIT_END определяет значение свойства type объекта события itemEditEnd.
DataGridEvent
  ITEM_FOCUS_IN : String = "itemFocusIn"
[статические] Константа DataGridEvent.ITEM_FOCUS_IN определяет значение свойства type объекта события itemFocusIn.
DataGridEvent
  ITEM_FOCUS_OUT : String = "itemFocusOut"
[статические] Константа DataGridEvent.ITEM_FOCUS_OUT определяет значение свойства type объекта события itemFocusOut.
DataGridEvent
 InheritedITEM_ROLL_OUT : String = "itemRollOut"
[статические] Задает значение свойства type для объекта события itemRollOut.
ListEvent
 InheritedITEM_ROLL_OVER : String = "itemRollOver"
[статические] Задает значение свойства type для объекта события itemRollOver.
ListEvent
 InheritedAIR-only LOCATION_CHANGE : String = "locationChange"
[статические] Константа Event.LOCATION_CHANGE определяет значение свойства type объекта события locationChange.
Event
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[статические] Константа Event.MOUSE_LEAVE определяет значение свойства type объекта события mouseLeave.
Event
 InheritedAIR-only NETWORK_CHANGE : String = "networkChange"
[статические] Константа Event.NETWORK_CHANGE определяет значение свойства type объекта события networkChange.
Event
 InheritedOPEN : String = "open"
[статические] Константа Event.OPEN определяет значение свойства type объекта open.
Event
 InheritedPASTE : String = "paste"
[статические] Задает значение свойства type для объекта события paste.
Event
 InheritedREMOVED : String = "removed"
[статические] Константа Event.REMOVED определяет значение свойства type объекта события removed.
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[статические] Константа REMOVED_FROM_STAGE определяет значение свойства type объекта события removedFromStage.
Event
 InheritedRENDER : String = "render"
[статические] Константа Event.RENDER определяет значение свойства type объекта события render.
Event
 InheritedRESIZE : String = "resize"
[статические] Константа Event.RESIZE определяет значение свойства type объекта события resize.
Event
 InheritedSCROLL : String = "scroll"
[статические] Константа Event.SCROLL определяет значение свойства type объекта события scroll.
Event
 InheritedSELECT : String = "select"
[статические] Константа Event.SELECT определяет значение свойства type объекта события select.
Event
 InheritedSELECT_ALL : String = "selectAll"
[статические] Задает значение свойства type для объекта события selectAll.
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[статические] Константа Event.SOUND_COMPLETE определяет значение свойства type объекта события soundComplete.
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[статические] Константа Event.TAB_CHILDREN_CHANGE определяет значение свойства type объекта события tabChildrenChange.
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[статические] Константа Event.TAB_ENABLED_CHANGE определяет значение свойства type объекта события tabEnabledChange.
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[статические] Константа Event.TAB_INDEX_CHANGE определяет значение свойства type объекта события tabIndexChange.
Event
 InheritedUNLOAD : String = "unload"
[статические] Константа Event.UNLOAD определяет значение свойства type объекта unload.
Event
 InheritedAIR-only USER_IDLE : String = "userIdle"
[статические] Константа Event.USER_IDLE определяет значение свойства type объекта события userIdle.
Event
 InheritedAIR-only USER_PRESENT : String = "userPresent"
[статические] Константа Event.USER_PRESENT определяет значение свойства type объекта события userPresent.
Event
Сведения о свойстве
dataFieldсвойство
dataField:String  [чтение и запись]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет или задает имя поля или свойства в данных, связанных со столбцом.



Реализация
    public function get dataField():String
    public function set dataField(value:String):void
itemRendererсвойство 
itemRenderer:Object  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет средство визуализации того редактируемого элемента или заголовка, который был щелкнут или размер которого был изменен.



Реализация
    public function get itemRenderer():Object
reasonсвойство 
reason:String  [только для чтения]

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Определяет причину отправки события itemEditEnd. Это свойство действительно только для событий типа DataGridEvent.ITEM_EDIT_END.

Возможные значения определены в классе DataGridEventReason.



Реализация
    public function get reason():String

См. также

Сведения о конструкторе
DataGridEvent()Конструктор
public function DataGridEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, columnIndex:int = -1, rowIndex:int = -1, itemRenderer:Object = null, dataField:String = null, reason:String = null)

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Создает новый объект DataGridEvent с заданными параметрами.

Параметры
type:String — Тип события; это значение указывает на действие, которое вызвало событие.
 
bubbles:Boolean (default = false) — Указывает, может ли событие вызвать показ всплывающей иерархии списка отображения.
 
cancelable:Boolean (default = false) — Определяет, можно ли отключить поведение, связанное с событием.
 
columnIndex:int (default = -1) — Отсчитываемое от нуля значение индекса столбца, содержащего средство визуализации.
 
rowIndex:int (default = -1) — Отсчитываемое от нуля значение индекса строки, содержащего средство визуализации.
 
itemRenderer:Object (default = null) — Средство визуализации для редактируемого элемента, либо средство визуализации заголовка, который щелкнул или растянул пользователь.
 
dataField:String (default = null) — Имя поля или свойства в данных, связанных со столбцом.
 
reason:String (default = null) — Причина отправки события itemEditEnd.

См. также

Сведения о методе
clone()метод
override public function clone():Event

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Создает копию объекта DataGridEvent и задает значение каждого свойства, совпадающее с оригиналом.

Возвращает
Event — Новый объект DataGridEvent, значения свойств которого соответствуют значениям оригинала.
toString()метод 
override public function toString():String

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Возвращает строку, содержащую все свойства объекта DataGridEvent. Строка имеет следующий формат:

[DataGridEvent type=значение bubbles=значение cancelable=значение columnIndex=значение rowIndex=значение itemRenderer=значение dataField=значение reason=значение]

Возвращает
String — Строка, содержащая все свойства объекта DataGridEvent.
Сведения о константе
COLUMN_STRETCHКонстанта
public static const COLUMN_STRETCH:String = "columnStretch"

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Константа DataGridEvent.COLUMN_STRETCH определяет значение свойства type объекта события columnStretch.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
columnIndexИндекс заголовка столбца, начинающийся с нуля, в массиве columns объекта DataGrid.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
dataFieldИмя поля или свойства в данных, связанных со столбцом элемента.
itemRendererСредство визуализации заголовка растянутого столбца.
reasonnull
rowIndexИндекс элемента в поставщике данных, начинающийся с нуля.
targetОбъект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие.


Пример

В следующем примере создается компонент DataGrid и выполняется прослушивание его события columnStretch:

import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;
import fl.data.DataProvider;
import fl.events.DataGridEvent;

var dp:DataProvider = new DataProvider();
dp.addItem({col1:"item 1.A", col2:"item 1.B", col3:"item 1.C"});
dp.addItem({col1:"item 2.A", col2:"item 2.B", col3:"item 2.C"});
dp.addItem({col1:"item 3.A", col2:"item 3.B", col3:"item 3.C"});
dp.addItem({col1:"item 4.A", col2:"item 4.B", col3:"item 4.C"});

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.addColumn("col1");
myDataGrid.addColumn("col2");
myDataGrid.addColumn("col3");
myDataGrid.dataProvider = dp;
myDataGrid.setSize(300, 200);
myDataGrid.move(10, 10);
myDataGrid.addEventListener(DataGridEvent.COLUMN_STRETCH, columnStretchHandler);
addChild(myDataGrid);

function columnStretchHandler(event:DataGridEvent):void {
    var dg:DataGrid = event.target as DataGrid;
    var column:DataGridColumn;
    var columnArray:Array = dg.columns;
    var dgColWidth:String;
    trace("resized column:", event.dataField);
    trace("columnIndex:", event.columnIndex);
    for each (column in columnArray) {
        dgColWidth = Number(column.width / dg.width * 100).toFixed(1);
        trace(column.dataField + ".width:", column.width + " pixels (" + dgColWidth + "%)");
    }
    trace("----------");
}
HEADER_RELEASEКонстанта  
public static const HEADER_RELEASE:String = "headerRelease"

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Константа DataGridEvent.HEADER_RELEASE определяет значение свойства type объекта события headerRelease.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
columnIndexИндекс заголовка столбца, начинающийся с нуля, в массиве columns объекта DataGrid.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
dataFieldИмя поля или свойства в данных, связанных со столбцом элемента.
itemRendererНажатое средство визуализации заголовка.
reasonnull
rowIndex-1
targetОбъект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие.


Пример

В следующем примере создается компонент DataGrid и выполняется прослушивание его события headerRelease:

import fl.controls.DataGrid;
import fl.controls.dataGridClasses.DataGridColumn;
import fl.data.DataProvider;
import fl.events.DataGridEvent;

var dp:DataProvider = new DataProvider();
dp.addItem({col1:"item 1.A", col2:"item 1.B", col3:"item 1.C"});
dp.addItem({col1:"item 2.A", col2:"item 2.B", col3:"item 2.C"});
dp.addItem({col1:"item 3.A", col2:"item 3.B", col3:"item 3.C"});
dp.addItem({col1:"item 4.A", col2:"item 4.B", col3:"item 4.C"});

var myDataGrid:DataGrid = new DataGrid();
myDataGrid.addColumn("col1");
myDataGrid.addColumn("col2");
myDataGrid.addColumn("col3");
myDataGrid.dataProvider = dp;
myDataGrid.setSize(300, 200);
myDataGrid.move(10, 10);
myDataGrid.addEventListener(DataGridEvent.HEADER_RELEASE, headerReleaseHandler);
addChild(myDataGrid);

function headerReleaseHandler(event:DataGridEvent):void {
    var dg:DataGrid = event.target as DataGrid;
    trace("dataField:", event.dataField, "(columnIndex:" + event.columnIndex + ")");
    trace("sortIndex:", dg.sortIndex);
    trace("sortDescending:", dg.sortDescending);
    trace("----------");
}
ITEM_EDIT_BEGINКонстанта  
public static const ITEM_EDIT_BEGIN:String = "itemEditBegin"

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Константа DataGridEvent.ITEM_EDIT_BEGIN определяет значение свойства type объекта события itemEditBegin.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
columnIndexИндекс заголовка столбца, начинающийся с нуля, в массиве columns объекта DataGrid.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
dataFieldnull
itemRendererСредство визуализации редактируемого элемента.
reasonnull
rowIndexИндекс элемента в поставщике данных, начинающийся с нуля.
targetОбъект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие.

См. также

ITEM_EDIT_BEGINNINGКонстанта  
public static const ITEM_EDIT_BEGINNING:String = "itemEditBeginning"

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Константа DataGridEvent.ITEM__EDIT_BEGINNING определяет значение свойства type объекта события itemEditBeginning.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
columnIndexИндекс заголовка столбца, начинающийся с нуля, в массиве columns объекта DataGrid.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
dataFieldИмя поля или свойства в данных, связанных со столбцом элемента.
itemRendererСредство визуализации редактируемого элемента.
reasonnull
rowIndexИндекс элемента в поставщике данных, начинающийся с нуля.
targetОбъект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие.

См. также

ITEM_EDIT_ENDКонстанта  
public static const ITEM_EDIT_END:String = "itemEditEnd"

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Константа DataGridEvent.ITEM_EDIT_END определяет значение свойства type объекта события itemEditEnd.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
columnIndexИндекс заголовка столбца, начинающийся с нуля, в массиве columns объекта DataGrid.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
dataFieldИмя поля или свойства в данных, связанных со столбцом элемента.
itemRendererСредство визуализации редактируемого элемента.
reasonКонстанта, определяющая причину события. Это значение должно принадлежать классу DataGridEventReason.
rowIndexИндекс элемента в поставщике данных, начинающийся с нуля.
targetОбъект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие.

См. также

ITEM_FOCUS_INКонстанта  
public static const ITEM_FOCUS_IN:String = "itemFocusIn"

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Константа DataGridEvent.ITEM_FOCUS_IN определяет значение свойства type объекта события itemFocusIn.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
columnIndexИндекс заголовка столбца, начинающийся с нуля, в массиве columns объекта DataGrid.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
dataFieldnull
itemRendererСредство визуализации редактируемого элемента.
reasonnull
rowIndexИндекс элемента в поставщике данных, начинающийся с нуля.
targetОбъект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие.

См. также

ITEM_FOCUS_OUTКонстанта  
public static const ITEM_FOCUS_OUT:String = "itemFocusOut"

Язык версии : ActionScript 3.0
Версии среды выполнения:  1.0 9.0.28.0

Константа DataGridEvent.ITEM_FOCUS_OUT определяет значение свойства type объекта события itemFocusOut.

Данное событие имеет следующие свойства.

СвойствоЗначение
bubblesfalse
cancelablefalse; нет поведения по умолчанию для отмены.
columnIndexИндекс заголовка столбца, начинающийся с нуля, в массиве columns объекта DataGrid.
currentTargetОбъект, активно обрабатывающий объект Event с помощью прослушивателя событий.
dataFieldnull
itemRendererСредство визуализации редактируемого элемента.
reasonnull
rowIndexИндекс элемента в поставщике данных, начинающийся с нуля.
targetОбъект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие.

См. также

Примеры Как пользоваться примерами
DataGridEventExample.as

В этом примере показано, как реагировать на события, отправляемые из DataGrid.

Чтобы применить этот пример на практике, выполните следующие действия.

  1. Добавьте компонент DataGrid в библиотеку.
  2. Сохраните этот код под именем DataGridEventExample.as в том же каталоге, где и FLA-файл.
  3. Присвойте классу Document в FLA-файле значение DataGridEventExample.
package
{
    import fl.controls.DataGrid;
    import fl.data.DataProvider;
    import fl.events.DataGridEvent;
    import fl.events.DataGridEventReason;
    import flash.display.Sprite;
    
    public class DataGridEventExample extends Sprite
    {
        private var dg:DataGrid;
        
        public function DataGridEventExample() {
            createDataGrid();
        }
        private function createDataGrid():void {
            dg = new DataGrid();
            addChild(dg);
            dg.setSize(200,300);
            dg.editable = true;
            
            var dp:DataProvider = new DataProvider();
            var i:uint;
            var totalRows:uint = 42;
            for(i=0; i<totalRows; i++) {
                dp.addItem( {     col1:getRandomNumber(),
                                   col2:getRandomNumber(),
                                col3:getRandomNumber() } );
            }
            dg.dataProvider = dp;
            dg.addEventListener(DataGridEvent.ITEM_EDIT_BEGIN, announceEditBegin);
            dg.addEventListener(DataGridEvent.ITEM_EDIT_END, announceEditEnd);
        }
        private function announceEditBegin(e:DataGridEvent):void {
            trace("Edit Begin on row: " + e.rowIndex + " col: " + e.columnIndex);    
        }
        private function announceEditEnd(e:DataGridEvent):void {
            var reason:String;
            switch(e.reason) {
                case DataGridEventReason.CANCELLED:
                    reason = "User cancelled edit";
                    break;
                case DataGridEventReason.NEW_ROW:
                    reason = "User focused to another row";
                    break;
                case DataGridEventReason.NEW_COLUMN:
                    reason = "User focused to another column";
                    break;
                case DataGridEventReason.OTHER:
                default:
                    reason = "Edit ended for other reason";
                    reason = e.reason;
                    break;                
            }
            trace("Edit End on row: " + e.rowIndex + " col: " + e.columnIndex);
            trace("Reason: " + reason.toString());    
        }
        private function getRandomNumber():uint {
            return Math.round(Math.random()*100);
        }
    }
}