| Пакет | fl.events |
| Класс | public class DataChangeEvent |
| Наследование | DataChangeEvent Event Object |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Этот класс обеспечивает следующее событие.
-
DataChangeEvent.DATA_CHANGE: отправляется при изменении данных компонента.
Связанные элементы API
| Свойство | Определено | ||
|---|---|---|---|
![]() | bubbles : Boolean [только для чтения]
Определяет, является ли событие событием восходящей цепочки. | Event | |
![]() | cancelable : Boolean [только для чтения]
Указывает, можно ли предотвратить поведение, связанное с событием. | Event | |
| changeType : String [только для чтения]
Определяет тип изменения, повлекшего событие. | DataChangeEvent | ||
![]() | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
![]() | currentTarget : Object [только для чтения]
Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. | Event | |
| endIndex : uint [только для чтения]
Определяет индекс последнего измененного элемента в массиве измененных элементов. | DataChangeEvent | ||
![]() | eventPhase : uint [только для чтения]
Текущая фаза в потоке событий. | Event | |
| items : Array [только для чтения]
Определяет массив, содержащий измененные элементы. | DataChangeEvent | ||
| startIndex : uint [только для чтения]
Определяет индекс первого измененного элемента в массиве измененных элементов. | DataChangeEvent | ||
![]() | target : Object [только для чтения]
Целевой объект события. | Event | |
![]() | type : String [только для чтения]
Тип события. | Event | |
| Метод | Определено | ||
|---|---|---|---|
DataChangeEvent(eventType:String, changeType:String, items:Array, startIndex:int = -1, endIndex:int = -1)
Создает новый объект DataChangeEvent с заданными параметрами. | DataChangeEvent | ||
[переопределить]
Создает копию объекта DataEvent и задает значение каждого параметра, совпадающее с оригиналом. | DataChangeEvent | ||
![]() |
Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event. | Event | |
![]() |
Показывает, определено ли заданное свойство для объекта. | Object | |
![]() |
Проверяет, выполнялся ли для события вызова метода preventDefault(). | Event | |
![]() |
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
![]() |
Отменяет поведение по умолчанию для события, если такое поведение можно отменить. | Event | |
![]() |
Показывает наличие заданного свойства и его перечисляемость. | Object | |
![]() |
Задает доступность динамического свойства для операций цикла. | Object | |
![]() |
Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом. | Event | |
![]() |
Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом. | Event | |
![]() |
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
[переопределить]
Возвращает строку, содержащую все свойства объекта DataChangeEvent. | DataChangeEvent | ||
![]() |
Возвращает элементарное значение заданного объекта. | Object | |
| Константа | Определено | ||
|---|---|---|---|
| DATA_CHANGE : String = "dataChange" [статические]
Задает значение свойства type для объекта события dataChange. | DataChangeEvent | ||
| PRE_DATA_CHANGE : String = "preDataChange" [статические]
Задает значение свойства type для объекта события preDataChange. | DataChangeEvent | ||
changeType | свойство |
changeType:String [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Определяет тип изменения, повлекшего событие. Класс DataChangeType определяет возможные значения этого свойства.
Реализация
public function get changeType():StringСвязанные элементы API
endIndex | свойство |
items | свойство |
startIndex | свойство |
DataChangeEvent | () | Конструктор |
public function DataChangeEvent(eventType:String, changeType:String, items:Array, startIndex:int = -1, endIndex:int = -1)| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Создает новый объект DataChangeEvent с заданными параметрами.
ПараметрыeventType:String — Тип события изменения.
| |
changeType:String — Тип внесенного изменения. Класс DataChangeType определяет возможные значения этого параметра.
| |
items:Array — Список измененных элементов.
| |
startIndex:int (default = -1) — Индекс первого измененного элемента.
| |
endIndex:int (default = -1) — Индекс последнего измененного элемента.
|
clone | () | метод |
override public function clone():Event| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Создает копию объекта DataEvent и задает значение каждого параметра, совпадающее с оригиналом.
ВозвращаетEvent — Новый объект DataChangeEvent, значения свойств которого соответствуют значениям оригинала.
|
toString | () | метод |
override public function toString():String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Возвращает строку, содержащую все свойства объекта DataChangeEvent. Строка имеет следующий формат:
[DataChangeEvent type=value changeType=value startIndex=value endIndex=value bubbles=value cancelable=value]
String — Строка, содержащая все свойства объекта DataChangeEvent.
|
DATA_CHANGE | Константа |
public static const DATA_CHANGE:String = "dataChange"| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Задает значение свойства type для объекта события dataChange.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
changeType | Определяет тип внесенного изменения. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
endIndex | Определяет индекс последнего измененного элемента. |
items | Массив, в котором перечислены измененные элементы. |
startIndex | Определяет индекс первого измененного элемента. |
target | Объект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие. |
Связанные элементы API
PRE_DATA_CHANGE | Константа |
public static const PRE_DATA_CHANGE:String = "preDataChange"| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flash CS3 |
| Версии среды выполнения: | Flash Player 9.0.28.0, AIR 1.0 |
Задает значение свойства type для объекта события preDataChange. Этот объект события отправляется перед тем, как в данные компонента вносятся изменения.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
changeType | Определяет тип вносимого изменения. |
currentTarget | Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. |
endIndex | Указывает индекс последнего изменяемого элемента. |
items | Массив, в котором перечислены изменяемые элементы. |
startIndex | Указывает индекс первого изменяемого элемента. |
target | Объект, отправивший событие. Адресат не всегда является объектом, выполняющим прослушивание события. Воспользуйтесь свойством currentTarget для доступа к объекту, прослушивающему событие. |
Связанные элементы API
- Добавьте классы DataGrid и Buttons в библиотеку.
- Сохраните этот код под именем DataChangeEventExample.as в том же каталоге, где и FLA-файл.
- Присвойте параметру DocumentClass в FLA-файле значение DataChangeEventExample.
package
{
import flash.display.Sprite;
import flash.events.MouseEvent;
import fl.data.DataProvider;
import fl.events.DataChangeEvent;
import fl.controls.DataGrid;
import fl.controls.Button;
public class DataChangeEventExample extends Sprite
{
private var dg:DataGrid;
private var dp:DataProvider;
private var names:Array = [ "Mary", "Bob", "Sue", "Joe" ];
public function DataChangeEventExample() {
dp = new DataProvider();
dp.addEventListener(DataChangeEvent.DATA_CHANGE,dataChanged);
dg = new DataGrid();
dg.move(10,45);
dg.setSize(300,250);
dg.columns = [ "name", "phone", "email" ];
addChild(dg);
var addContactBtn:Button = new Button();
addContactBtn.label = "Add Contact";
addContactBtn.move(10,10);
addContactBtn.addEventListener(MouseEvent.CLICK, addContact);
addChild(addContactBtn);
}
private function getRandomPhone():String {
return randomDigit()+randomDigit()+randomDigit()+"-"+randomDigit()+randomDigit()+randomDigit()+"-"+randomDigit()+randomDigit()+randomDigit()+randomDigit();
}
private function randomDigit():String {
return String(Math.round(Math.random()*10)%10);
}
private function getRandomName():String {
return names[Math.round(Math.random()*names.length)%names.length];
}
private function addContact(e:MouseEvent):void {
var randomName:String = getRandomName()
dp.addItem( { name: randomName, phone: getRandomPhone(), email: randomName + "@fictitious.com" } );
}
private function dataChanged(e:DataChangeEvent):void {
var changedItems:Array = e.items;
dg.addItem(changedItems[0]);
}
}
}
Tue Jun 12 2018, 11:34 AM Z
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства