Пакет | mx.events |
Класс | public class DataGridEvent |
Наследование | DataGridEvent ![]() ![]() |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Связанные элементы API
Свойство | Определено | ||
---|---|---|---|
![]() | bubbles : Boolean [только для чтения]
Определяет, является ли событие событием восходящей цепочки. | Event | |
![]() | cancelable : Boolean [только для чтения]
Указывает, можно ли предотвратить поведение, связанное с событием. | Event | |
columnIndex : int
Отсчитываемый от нуля индекс в массиве columns объекта DataGrid для столбца, связанного с событием. | DataGridEvent | ||
![]() | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
![]() | currentTarget : Object [только для чтения]
Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. | Event | |
dataField : String
Имя поля или свойства данных, связанных со столбцом. | DataGridEvent | ||
![]() | eventPhase : uint [только для чтения]
Текущая фаза в потоке событий. | Event | |
itemRenderer : IListItemRenderer
Средство визуализации для редактируемого элемента, либо средство визуализации заголовка, который щелкнул или растянул пользователь. | DataGridEvent | ||
localX : Number
Позиция столбца по оси X; используется для повторного воспроизведения событий растяжения столбца. | DataGridEvent | ||
reason : String
Причина, по которой было передано событие itemEditEnd. | DataGridEvent | ||
rowIndex : int
Отсчитываемый от нуля индекс элемента в поставщике данных. | DataGridEvent | ||
![]() | target : Object [только для чтения]
Целевой объект события. | Event | |
![]() | type : String [только для чтения]
Тип события. | Event |
Метод | Определено | ||
---|---|---|---|
DataGridEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, columnIndex:int = -1, dataField:String = null, rowIndex:int = -1, reason:String = null, itemRenderer:IListItemRenderer = null, localX:Number = NaN)
Конструктор. | DataGridEvent | ||
![]() |
Создает дубликат экземпляра подкласса Event. | Event | |
![]() |
Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event. | Event | |
![]() |
Показывает, определено ли заданное свойство для объекта. | Object | |
![]() |
Проверяет, выполнялся ли для события вызова метода preventDefault(). | Event | |
![]() |
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
![]() |
Отменяет поведение по умолчанию для события, если такое поведение можно отменить. | Event | |
![]() |
Показывает наличие заданного свойства и его перечисляемость. | Object | |
![]() |
Задает доступность динамического свойства для операций цикла. | Object | |
![]() |
Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом. | Event | |
![]() |
Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом. | Event | |
![]() |
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
![]() |
Возвращает строку, содержащую все свойства объекта Event. | Event | |
![]() |
Возвращает элементарное значение заданного объекта. | Object |
Константа | Определено | ||
---|---|---|---|
COLUMN_STRETCH : String = "columnStretch" [статические]
Константа DataGridEvent.COLUMN_STRETCH определяет значение свойства type объекта события columnStretch, указывающего на то, что пользователь увеличил столбец в горизонтальном направлении. | DataGridEvent | ||
HEADER_RELEASE : String = "headerRelease" [статические]
Константа AdvancedDataGridEvent.HEADER_RELEASE определяет значение свойства type объекта события headerRelease, указывающего на то, что пользователь нажал и отпустил кнопку мыши на заголовке столбца. | DataGridEvent | ||
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_EDITOR_CREATE : String = "itemEditorCreate" [статические]
Константа DataGridEvent.ITEM_EDITOR_CREATE определяет значение свойства type объекта события для события itemEditorCreate, указывающего на то, что сеткой данных было завершено создание редактора элементов. | 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 |
columnIndex | свойство |
public var columnIndex:int
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Отсчитываемый от нуля индекс в массиве columns
объекта DataGrid для столбца, связанного с событием.
dataField | свойство |
public var dataField:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Имя поля или свойства данных, связанных со столбцом.
itemRenderer | свойство |
public var itemRenderer:IListItemRenderer
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Средство визуализации для редактируемого элемента, либо средство визуализации заголовка, который щелкнул или растянул пользователь. Это свойств позволяет получать доступ к элементу поставщика данных.
localX | свойство |
public var localX:Number
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Позиция столбца по оси X; используется для повторного воспроизведения событий растяжения столбца.
reason | свойство |
public var reason:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Причина, по которой было передано событие itemEditEnd
. Допустимо только для событий, относящихся к типу ITEM_EDIT_END
. Возможные значения определены в классе DataGridEventReason.
Связанные элементы API
rowIndex | свойство |
public var rowIndex:int
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Отсчитываемый от нуля индекс элемента в поставщике данных.
DataGridEvent | () | Конструктор |
public function DataGridEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, columnIndex:int = -1, dataField:String = null, rowIndex:int = -1, reason:String = null, itemRenderer:IListItemRenderer = null, localX:Number = NaN)
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Конструктор. Как правило, вызывается объектом DataGrid; в коде приложения не используется.
Параметрыtype:String — Тип события; указывает действие, вызвавшее событие.
| |
bubbles:Boolean (default = false ) — Указывает, может ли событие передаваться вверх по иерархии списка отображения.
| |
cancelable:Boolean (default = false ) — Указывает, существует ли возможность предотвращения поведения, связанного с событием.
| |
columnIndex:int (default = -1 ) — Отсчитываемый от нуля индекс столбца, в котором произошло событие.
| |
dataField:String (default = null ) — Имя поля или свойства данных, связанных со столбцом.
| |
rowIndex:int (default = -1 ) — Отсчитываемый от нуля индекс элемента в поставщике данных.
| |
reason:String (default = null ) — Причина для события itemEditEnd .
| |
itemRenderer:IListItemRenderer (default = null ) — Редактируемое средство визуализации элементов или средство визуализации заголовка, в области которого был произведен щелчок.
| |
localX:Number (default = NaN ) — Позиция столбца по оси X для повторного воспроизведения события columnStretch .
|
COLUMN_STRETCH | Константа |
public static const COLUMN_STRETCH:String = "columnStretch"
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Константа DataGridEvent.COLUMN_STRETCH определяет значение свойства type
объекта события columnStretch
, указывающего на то, что пользователь увеличил столбец в горизонтальном направлении.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false |
columnIndex | Отсчитываемый от нуля индекс столбца элемента в массиве columns объекта DataGrid. |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
dataField | Имя поля или свойства данных, связанных со столбцом. |
itemRenderer | null |
localX | Позиция мыши по оси Х. |
reason | null |
rowIndex | Отсчитываемый от нуля индекс элемента в поставщике данных. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
type | DataGridEvent.COLUMN_STRETCH |
HEADER_RELEASE | Константа |
public static const HEADER_RELEASE:String = "headerRelease"
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Константа AdvancedDataGridEvent.HEADER_RELEASE определяет значение свойства type
объекта события headerRelease
, указывающего на то, что пользователь нажал и отпустил кнопку мыши на заголовке столбца.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | true |
columnIndex | Отсчитываемый от нуля индекс столбца элемента в массиве columns объекта DataGrid. |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
dataField | Имя поля или свойства данных, связанных со столбцом. |
itemRenderer | Средство визуализации заголовка, которое было инициировано. |
localX | NaN |
reason | null |
rowIndex | null |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
type | DataGridEvent.HEADER_RELEASE |
ITEM_EDIT_BEGIN | Константа |
public static const ITEM_EDIT_BEGIN:String = "itemEditBegin"
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Константа DataGridEvent.ITEM_EDIT_BEGIN определяет значение свойства type
объекта события для события itemEditBegin
, указывающего на то, что элемент готов к редактированию.
Прослушиватель по умолчанию для этого события выполняет следующие действия:
- Создает объект редактора элементов посредством вызова метода
createItemEditor()
. - Копирует свойство
data
из элемента в редактор. По умолчанию объект редактора элементов является экземпляром элемента управления TextInput. СвойствоitemEditor
элемента управления List используется для указания пользовательского класса редактора элементов. - Настройка свойства
itemEditorInstance
элемента управления List для ссылки на экземпляр редактора элементов.
Для изменения данных, передаваемых в редактор элементов, можно создать прослушиватель события для этого события. Например, могли измениться данные, формат или другая информация, используемая редактором элементов.
Кроме того, можно создать прослушиватель события для указания редактора элементов, используемого для изменения элемента. Например, могут существовать два различных редактора элементов. В прослушивателе события можно просматривать редактируемые данные или другую информацию и открывать соответствующий редактор элементов путем выполнения действий, описанных ниже.
- Можно вызвать метод
preventDefault()
для предотвращения выполнения вызова методаcreateItemEditor()
в качестве части прослушивателя события по умолчанию. - Можно настроить свойства
itemEditor
в соответствии с редактором. - Можно вызвать метод
createItemEditor()
.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | true |
columnIndex | Отсчитываемый от нуля индекс столбца элемента в массиве columns объекта DataGrid. |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
dataField | null |
itemRenderer | Средство визуализации элементов для редактируемого элемента. |
localX | NaN |
reason | null |
rowIndex | Отсчитываемый от нуля индекс элемента в поставщике данных. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
type | DataGridEvent.ITEM_EDIT_BEGIN |
ITEM_EDIT_BEGINNING | Константа |
public static const ITEM_EDIT_BEGINNING:String = "itemEditBeginning"
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Константа DataGridEvent.ITEM__EDIT_BEGINNING определяет значение свойства type
объекта события itemEditBeginning
, указывающего на готовность пользователя к редактированию элемента, например отпустил кнопку мыши на элементе.
Прослушиватель по умолчанию для этого события устанавливает в качестве значения свойства DataGrid.editedItemPosition
элемент, на который переключен фокус, что позволяет начать сеанс редактирования элемента.
Как правило, для запрещения редактирования определенного элемента или элементов пользователь создает собственный прослушиватель события для этого события. Для предотвращения выполнения прослушивателя по умолчанию выполняется вызов метода preventDefault()
из собственного прослушивателя события для этого события.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | true |
columnIndex | Отсчитываемый от нуля индекс столбца элемента в массиве columns объекта DataGrid. |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
dataField | Имя поля или свойства данных, связанного со столбцом элемента. |
itemRenderer | Средство визуализации элементов для редактируемого элемента. Это свойство имеет значение null, если указанное событие генерируется клавиатурой, поскольку элемент, подлежащий редактированию, может в данный момент времени не отображаться на экране. |
localX | NaN |
reason | null |
rowIndex | Отсчитываемый от нуля индекс элемента в поставщике данных. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
type | DataGridEvent.ITEM_EDIT_BEGINNING |
ITEM_EDIT_END | Константа |
public static const ITEM_EDIT_END:String = "itemEditEnd"
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Константа DataGridEvent.ITEM_EDIT_END определяет значение свойства type
объекта события itemEditEnd
, указывающего на завершение сеанса редактирования.
Компоненты списка имеют средство обработки по умолчанию для этого события, которое копирует данные из редактора элементов в поставщик данных элемента управления List. Прослушиватель события по умолчанию выполняет следующие действия:
- Использует свойство
editorDataField
DataGridColumn, связанного с этим событием для определения свойства редактора элементов, содержащего новые данные, и обновляет элемент поставщика данных в соответствии с этими новыми данными. Поскольку редактор элементов по умолчанию является элементом управления TextInput, значением по умолчанию для свойстваeditorDataField
являетсяtext
, указывающее, что свойствоtext
элемента управления TextInput содержит новые данные элемента. - Выполняет вызов метода
destroyItemEditor()
для закрытия редактора элементов.
Как правило, пользователь создает прослушиватель события для этого события в целях выполнения следующих действий:
- В прослушивателе события можно изменять данные, возвращаемые редактором в компонент списка. Например, можно переформатировать данные перед их возвратом в элемент управления List. По умолчанию редактор элементов может возвращать только отдельное значение. Если требуется возврат нескольких значений, необходимо создать прослушиватель события для события
itemEditEnd
. - В прослушивателе события можно просматривать данные, введенные в редактор элементов. Если данные являются неправильными, можно выполнить вызов метода
preventDefault()
, что позволит предотвратить возврат новых данных в элемент управления List и закрытие редактора.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | true |
columnIndex | Отсчитываемый от нуля индекс столбца элемента в массиве columns объекта DataGrid. |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
dataField | Имя поля или свойства данных, связанного со столбцом элемента. |
itemRenderer | Средство визуализации элементов для редактируемого элемента. |
localX | NaN |
reason | Константа, определяющая причину события. Это значение должно быть элементом класса DataGridEventReason . |
rowIndex | Отсчитываемый от нуля индекс элемента в поставщике данных. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
type | DataGridEvent.ITEM_EDIT_END |
ITEM_EDITOR_CREATE | Константа |
public static const ITEM_EDITOR_CREATE:String = "itemEditorCreate"
Константа DataGridEvent.ITEM_EDITOR_CREATE определяет значение свойства type
объекта события для события itemEditorCreate
, указывающего на то, что сеткой данных было завершено создание редактора элементов.
Отсутствует прослушиватель по умолчанию для этого события.
Как правило, записывается личный прослушиватель событий для разрешения внесения пользовательских изменений в itemEditor
перед тем, как пользователь может начать редактирование.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | true |
columnIndex | Отсчитываемый от нуля индекс столбца элемента в массиве columns объекта DataGrid. |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
dataField | null |
itemRenderer | null |
localX | NaN |
reason | null |
rowIndex | Отсчитываемый от нуля индекс элемента в поставщике данных. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
type | DataGridEvent.ITEM_EDITOR_CREATE |
ITEM_FOCUS_IN | Константа |
public static const ITEM_FOCUS_IN:String = "itemFocusIn"
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Константа DataGridEvent.ITEM_FOCUS_IN определяет значение свойства type
объекта события itemFocusIn
, указывающего на перемещение фокуса на этот элемент.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false |
columnIndex | Отсчитываемый от нуля индекс столбца элемента в массиве columns объекта DataGrid. |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
dataField | null |
itemRenderer | Экземпляр редактора элементов для редактируемого элемента. |
localX | NaN |
reason | null |
rowIndex | Отсчитываемый от нуля индекс элемента в поставщике данных. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
type | DataGridEvent.ITEM_FOCUS_IN |
ITEM_FOCUS_OUT | Константа |
public static const ITEM_FOCUS_OUT:String = "itemFocusOut"
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Константа DataGridEvent.ITEM_FOCUS_OUT определяет значение свойства type
объекта события itemFocusOut
, указывающего на перемещение фокуса за пределы элемента.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false |
columnIndex | Отсчитываемый от нуля индекс столбца элемента в массиве columns объекта DataGrid. |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
dataField | null |
itemRenderer | Экземпляр редактора элементов для редактируемого элемента. |
localX | NaN |
reason | null |
rowIndex | Отсчитываемый от нуля индекс элемента в поставщике данных. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
type | DataGridEvent.ITEM_FOCUS_OUT |
Tue Jun 12 2018, 11:34 AM Z