Пакет | mx.events |
Класс | public class ListEvent |
Наследование | ListEvent Event Object |
Подклассы | MenuEvent |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Связанные элементы API
Свойство | Определено | ||
---|---|---|---|
bubbles : Boolean [только для чтения]
Определяет, является ли событие событием восходящей цепочки. | Event | ||
cancelable : Boolean [только для чтения]
Указывает, можно ли предотвратить поведение, связанное с событием. | Event | ||
columnIndex : int
Отсчитываемый от нуля индекс столбца, содержащий средство визуализации элементов, где произошло событие. | ListEvent | ||
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
currentTarget : Object [только для чтения]
Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. | Event | ||
eventPhase : uint [только для чтения]
Текущая фаза в потоке событий. | Event | ||
itemRenderer : IListItemRenderer
Средство визуализации элементов, где произошло событие. | ListEvent | ||
reason : String
Причина, по которой было передано событие itemEditEnd. | ListEvent | ||
rowIndex : int
Используется в отсчитываемом от нуля индексе строки, содержащей средство визуализации элементов, где произошло событие, или для редактирования событий с индексом элемента, который предполагается редактировать в поставщике данных. | ListEvent | ||
target : Object [только для чтения]
Целевой объект события. | Event | ||
type : String [только для чтения]
Тип события. | Event |
Метод | Определено | ||
---|---|---|---|
ListEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, columnIndex:int = -1, rowIndex:int = -1, reason:String = null, itemRenderer:IListItemRenderer = null)
Конструктор. | ListEvent | ||
Создает дубликат экземпляра подкласса Event. | Event | ||
Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event. | Event | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
Проверяет, выполнялся ли для события вызова метода preventDefault(). | Event | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Отменяет поведение по умолчанию для события, если такое поведение можно отменить. | Event | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом. | Event | ||
Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом. | Event | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
Возвращает строку, содержащую все свойства объекта Event. | Event | ||
Возвращает элементарное значение заданного объекта. | Object |
Константа | Определено | ||
---|---|---|---|
CHANGE : String = "change" [статические]
Константа ListEvent.CHANGE определяет значение свойства type объекта ListEvent для события change, указывающего, что выбор изменялся в результате действий пользователя. | ListEvent | ||
ITEM_CLICK : String = "itemClick" [статические]
Константа ListEvent.ITEM_CLICK определяет значение свойства type объекта ListEvent для события itemClick, указывающего на выполнение пользователем щелчка кнопкой мыши по видимому элементу в элементе управления. | ListEvent | ||
ITEM_DOUBLE_CLICK : String = "itemDoubleClick" [статические]
Константа ListEvent.ITEM_DOUBLE_CLICK определяет значение свойства type объекта ListEvent для события itemDoubleClick, указывающего на выполнение пользователем двойного щелчка кнопкой мыши по видимому элементу в элементе управления. | ListEvent | ||
ITEM_EDIT_BEGIN : String = "itemEditBegin" [статические]
Константа ListEvent.ITEM_EDIT_BEGIN определяет значение свойства type объекта события itemEditBegin, указывающего, что элемент готов к редактированию. | ListEvent | ||
ITEM_EDIT_BEGINNING : String = "itemEditBeginning" [статические]
Константа ListEvent.ITEM_EDIT_BEGINNING определяет значение type свойства объекта ListEvent для события itemEditBeginning, указывающего на готовность пользователя к редактированию элемента, например отпустил кнопку мыши на элементе. | ListEvent | ||
ITEM_EDIT_END : String = "itemEditEnd" [статические]
Константа ListEvent.ITEM_EDIT_END определяет значение type свойства объекта ListEvent для события itemEditEnd, указывающего на завершение сеанса редактирования. | ListEvent | ||
ITEM_FOCUS_IN : String = "itemFocusIn" [статические]
Константа ListEvent ITEM_FOCUS_IN определяет значение свойства type объекта ListEvent для события itemFocusIn, указывающего на перемещение фокуса на элемент. | ListEvent | ||
ITEM_FOCUS_OUT : String = "itemFocusOut" [статические]
Константа ListEvent.ITEM_FOCUS_OUT определяет значение свойства type объекта ListEvent для события itemFocusOut, указывающего на перемещение фокуса за пределы элемента. | ListEvent | ||
ITEM_ROLL_OUT : String = "itemRollOut" [статические]
Константа ListEvent.ITEM_ROLL_OUT определяет значение свойства type объекта ListEvent для события itemRollOut, указывающего, что пользователь переместил указатель мыши за пределы области видимого элемента в элементе управления. | ListEvent | ||
ITEM_ROLL_OVER : String = "itemRollOver" [статические]
Константа ListEvent.ITEM_ROLL_OVER определяет значение свойства type объекта ListEvent для события itemRollOver, указывающего, что пользователь провел указатель мыши над видимым элементом в элементе управления. | ListEvent |
columnIndex | свойство |
public var columnIndex:int
Язык версии: | 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 |
Средство визуализации элементов, где произошло событие. Это свойств позволяет получать доступ к элементу поставщика данных.
reason | свойство |
public var reason:String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Причина, по которой было передано событие itemEditEnd
. Допустимо только для событий, относящихся к типу ITEM_EDIT_END
. Возможные значения определены в классе ListEventReason.
Связанные элементы API
rowIndex | свойство |
public var rowIndex:int
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Используется в отсчитываемом от нуля индексе строки, содержащей средство визуализации элементов, где произошло событие, или для редактирования событий с индексом элемента, который предполагается редактировать в поставщике данных.
ListEvent | () | Конструктор |
public function ListEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, columnIndex:int = -1, rowIndex:int = -1, reason:String = null, itemRenderer:IListItemRenderer = null)
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Конструктор. Как правило, вызывается управляющим элементом Flex и не используется в коде приложения.
Параметрыtype:String — Тип события; указывает действие, вызвавшее событие.
| |
bubbles:Boolean (default = false ) — Указывает, может ли событие передаваться вверх по иерархии списка отображения.
| |
cancelable:Boolean (default = false ) — Указывает, существует ли возможность предотвращения поведения, связанного с событием.
| |
columnIndex:int (default = -1 ) — Отсчитываемый от нуля индекс столбца, содержащего средство визуализации.
| |
rowIndex:int (default = -1 ) — Отсчитываемый от нуля индекс строки, содержащей средство визуализации, или индекс редактируемого элемента в поставщике данных для событий редактирования
| |
reason:String (default = null ) — Причина для события itemEditEnd .
| |
itemRenderer:IListItemRenderer (default = null ) — Cредства визуализации элементов для элемента поставщика данных.
|
CHANGE | Константа |
public static const CHANGE:String = "change"
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Константа ListEvent.CHANGE определяет значение свойства type
объекта ListEvent для события change
, указывающего, что выбор изменялся в результате действий пользователя.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false |
columnIndex | Отсчитываемый от нуля индекс столбца, связанного с событием. |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
itemRenderer | Произведен щелчок средства визуализации элементов. |
reason | null |
rowIndex | Отсчитываемый от нуля индекс элемента, связанного с событием. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
Тип | ListEvent.CHANGE |
ITEM_CLICK | Константа |
public static const ITEM_CLICK:String = "itemClick"
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Константа ListEvent.ITEM_CLICK определяет значение свойства type
объекта ListEvent для события itemClick
, указывающего на выполнение пользователем щелчка кнопкой мыши по видимому элементу в элементе управления.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false |
columnIndex | Отсчитываемый от нуля индекс столбца, связанного с событием. |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
itemRenderer | Произведен щелчок средства визуализации элементов. |
reason | null |
rowIndex | Отсчитываемый от нуля индекс элемента, связанного с событием. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
Тип | ListEvent. ITEM_CLICK |
ITEM_DOUBLE_CLICK | Константа |
public static const ITEM_DOUBLE_CLICK:String = "itemDoubleClick"
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Константа ListEvent.ITEM_DOUBLE_CLICK определяет значение свойства type
объекта ListEvent для события itemDoubleClick
, указывающего на выполнение пользователем двойного щелчка кнопкой мыши по видимому элементу в элементе управления.
Для получения событий itemDoubleClick следует установить свойство doubleClickEnabled
компонента равным true
.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false |
columnIndex | Отсчитываемый от нуля индекс столбца, связанного с событием. |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
itemRenderer | Выбираемое двойным щелчком мыши средство визуализации элементов. |
reason | null |
rowIndex | Отсчитываемый от нуля индекс элемента, связанного с событием. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
Тип | ListEvent.ITEM_DOUBLE_CLICK |
ITEM_EDIT_BEGIN | Константа |
public static const ITEM_EDIT_BEGIN:String = "itemEditBegin"
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Константа ListEvent.ITEM_EDIT_BEGIN определяет значение свойства type
объекта события itemEditBegin
, указывающего, что элемент готов к редактированию.
Прослушиватель по умолчанию для этого события выполняет следующие действия:
- Создает объект редактора элементов посредством вызова метода
createItemEditor()
. - Копирует свойство
data
из элемента в редактор. По умолчанию объект редактора элементов является экземпляром элемента управления TextInput. СвойствоitemEditor
элемента управления List используется для указания пользовательского класса редактора элементов. - Настройка свойства
itemEditorInstance
элемента управления List для ссылки на экземпляр редактора элементов.
Для изменения данных, передаваемых в редактор элементов, можно создать прослушиватель события для этого события. Например, могли измениться данные, формат или другая информация, используемая редактором элементов.
Кроме того, можно создать прослушиватель события для указания редактора элементов, используемого для изменения элемента. Например, могут существовать два различных редактора элементов. В прослушивателе события можно просматривать редактируемые данные или другую информацию и открывать соответствующий редактор элементов путем выполнения действий, описанных ниже.
- Можно вызвать метод
preventDefault()
для предотвращения выполнения вызова методаcreateItemEditor()
в качестве части прослушивателя события по умолчанию. - Можно настроить свойства
itemEditor
в соответствии с редактором. - Можно вызвать метод
createItemEditor()
.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | true |
columnIndex | Отсчитываемый от нуля индекс столбца, связанного с событием. |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
itemRenderer | Средство визуализации элементов для редактируемого элемента. |
reason | null |
rowIndex | Отсчитываемый от нуля индекс элемента, связанного с событием. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
Тип | ListEvent.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 |
Константа ListEvent.ITEM_EDIT_BEGINNING определяет значение type
свойства объекта ListEvent для события itemEditBeginning
, указывающего на готовность пользователя к редактированию элемента, например отпустил кнопку мыши на элементе.
Прослушиватель по умолчанию для этого события устанавливает в качестве значения свойства List.editedItemPosition
элемент, на который переключен фокус, что позволяет начать сеанс редактирования элемента.
Как правило, для запрещения редактирования определенного элемента или элементов пользователь создает собственный прослушиватель события для этого события. Для предотвращения выполнения прослушивателя по умолчанию выполняется вызов метода preventDefault()
из собственного прослушивателя события для этого события.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | true |
columnIndex | Отсчитываемый от нуля индекс столбца, связанного с событием. |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
itemRenderer | Средство визуализации элементов для редактируемого элемента. Это свойство имеет значение null, если указанное событие генерируется клавиатурой, поскольку элемент, подлежащий редактированию, может в данный момент времени не отображаться на экране. |
reason | null |
rowIndex | Отсчитываемый от нуля индекс элемента, связанного с событием. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
Тип | ListEvent.ITEM_EDIT_BEGIN |
ITEM_EDIT_END | Константа |
public static const ITEM_EDIT_END:String = "itemEditEnd"
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Константа ListEvent.ITEM_EDIT_END определяет значение type
свойства объекта ListEvent для события itemEditEnd
, указывающего на завершение сеанса редактирования.
Компоненты списка имеют средство обработки по умолчанию для этого события, которое копирует данные из редактора элементов в поставщик данных элемента управления List. Прослушиватель события по умолчанию выполняет следующие действия:
- Использует свойство
editorDataField
элемента управления List для определения свойств редактора элементов, содержащего новые данные, и обновляет элемент поставщика данных в соответствии с новыми данными. Поскольку редактор элементов по умолчанию является элементом управления TextInput, значением по умолчанию для свойстваeditorDataField
являетсяtext
, указывающее, что свойствоtext
элемента управления TextInput содержит новые данные элемента. - Выполняет вызов метода
destroyItemEditor()
для закрытия редактора элементов.
Как правило, пользователь создает прослушиватель события для этого события в целях выполнения следующих действий:
- В прослушивателе события можно изменять данные, возвращаемые редактором в компонент списка. Например, можно переформатировать данные перед их возвратом в элемент управления List. По умолчанию редактор элементов может возвращать только отдельное значение. Если требуется возврат нескольких значений, необходимо создать прослушиватель события для события
itemEditEnd
. - В прослушивателе события можно просматривать данные, введенные в редактор элементов. Если данные являются неправильными, можно выполнить вызов метода
preventDefault()
, что позволит предотвратить возврат новых данных в элемент управления List и закрытие редактора.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | true |
columnIndex | Отсчитываемый от нуля индекс столбца, связанного с событием. |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
itemRenderer | Средство визуализации редактируемого элемента. |
reason | Константа, определяющая причину события. Значение должно принадлежать классу ListEventReson . |
rowIndex | Отсчитываемый от нуля индекс элемента, связанного с событием. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
Тип | ListEvent.ITEM_EDIT_END |
ITEM_FOCUS_IN | Константа |
public static const ITEM_FOCUS_IN:String = "itemFocusIn"
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Константа ListEvent ITEM_FOCUS_IN определяет значение свойства type
объекта ListEvent для события itemFocusIn
, указывающего на перемещение фокуса на элемент.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | true |
columnIndex | Отсчитываемый от нуля индекс столбца, связанного с событием. |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
itemRenderer | Экземпляр редактора элементов для редактируемого элемента. |
reason | null |
rowIndex | Отсчитываемый от нуля индекс элемента, связанного с событием. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
Тип | ListEvent.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 |
Константа ListEvent.ITEM_FOCUS_OUT определяет значение свойства type
объекта ListEvent для события itemFocusOut
, указывающего на перемещение фокуса за пределы элемента.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false |
columnIndex | Отсчитываемый от нуля индекс столбца, связанного с событием. |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
itemRenderer | Экземпляр редактора элементов для редактируемого элемента. |
reason | null |
rowIndex | Отсчитываемый от нуля индекс элемента, связанного с событием. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
Тип | ListEvent.ITEM_FOCUS_OUT |
ITEM_ROLL_OUT | Константа |
public static const ITEM_ROLL_OUT:String = "itemRollOut"
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Константа ListEvent.ITEM_ROLL_OUT определяет значение свойства type
объекта ListEvent для события itemRollOut
, указывающего, что пользователь переместил указатель мыши за пределы области видимого элемента в элементе управления.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false |
columnIndex | Отсчитываемый от нуля индекс столбца, связанного с событием. |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
itemRenderer | Средство визуализации, с которого пользователь убрал указатель мыши. |
reason | null |
rowIndex | Отсчитываемый от нуля индекс элемента, связанного с событием. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
Тип | ListEvent.ITEM_ROLL_OUT |
ITEM_ROLL_OVER | Константа |
public static const ITEM_ROLL_OVER:String = "itemRollOver"
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Константа ListEvent.ITEM_ROLL_OVER определяет значение свойства type
объекта ListEvent для события itemRollOver
, указывающего, что пользователь провел указатель мыши над видимым элементом в элементе управления.
Свойства объекта события имеют следующие значения:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false |
columnIndex | Отсчитываемый от нуля индекс столбца, связанного с событием. |
currentTarget | Объект, определяющий прослушиватель события, который выполняет обработку события. Например, если используется myButton.addEventListener() для регистрации прослушивателя события, значением currentTarget является myButton. |
itemRenderer | Средство визуализации, над которым пользователь провел указатель мыши. |
reason | null |
rowIndex | Отсчитываемый от нуля индекс элемента, связанного с событием. |
target | Объект, отправивший событие. Это не всегда тот объект, который прослушивает событие. Свойство currentTarget всегда используется для получения доступа к объекту, прослушивающему событие. |
Тип | ListEvent.ITEM_ROLL_OVER |
Tue Jun 12 2018, 11:34 AM Z