Описание
Класс Event используется как базовый класс для создания объектов Event, которые передаются прослушивателям событий в качестве параметров, когда происходит какое-либо событие. Методы в функциях прослушивателя событий можно использовать для изменения поведения объекта Event. Например, можно сделать текущий прослушиватель события последним в очереди на обработку событий, вызвав метод stopPropagation() или stopImmediatePropagation().
Синтаксис
new flwebgl.events.Event(type, bubbles)
Параметры
| Имя | Тип | Описание |
| тип | string | Тип события |
| всплывающие события | булево | Определяет присутствие объекта Event в рабочей области всплывания потока событий. Значение по умолчанию равно false |
Статические свойства
| Имя | Тип | Описание |
| flwebgl.events.Event.ENTER_FRAME | string | Отправляется всякий раз, когда ролик входит в кадр (до обработки анимации на временной шкале) |
| flwebgl.events.Event.ADDED | string | Отправляется, когда экранный элемент добавляется в качестве дочернего элемента. |
| flwebgl.events.Event.FRAME_CONSTRUCTED | string | Отправляется после построения текущего кадра (перед обработкой сценариев кадра). |
| flwebgl.events.Event.EXIT_FRAME | string | Отправляется всякий раз, когда ролик выходит из кадра (после обработки анимации на временной шкале) |
| flwebgl.events.Event.REMOVED | string | Отправляется перед тем, как экранный элемент удаляется из родительского элемента. |
Методы
getBubbles()
Описание
Этот метод указывает, всплывает событие или нет.
Возвращает
- Тип — логическое значение
getCurrentTarget()
Описание
Этот метод возвращает объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
Возвращает
- Тип — flwebgl.events.EventDispatcher
Пример
Этот фрагмент кода добавляет прослушиватель события одновременно в рабочую область и к самому верхнему дочернему элементу (mc). Когда к mc добавляется дочерний элемент, выполняется прослушиватель события (handlerFn2). Когда событие ADDED всплывает, оно отправляется в верхнюю часть иерархии к прослушивателям событий (handlerFn1) после выполнения всех прослушивателей mc.
function handlerFn1(e) {
console.log("Handler 1");
var t1 = e.getTarget(); // First child of stage
var t2 = e.getCurrentTarget(); // Stage
}
function handlerFn2(e) {
console.log("Handler 2");
var t1 = e.getTarget(); // First child of stage
var t2 = e.getCurrentTarget();// First child of stage
}
var stage = player.getStage();
var mc = player.getChildAt(0);
stage.addEventListener(flwebgl.events.Event.ADDED, handlerFn1);
mc.addEventListener(flwebgl.events.Event.ADDED, handlerFn2);
getTarget()
Описание
Этот метод возвращает назначение события.
Возвращает
- Тип — flwebgl.events.EventDispatcher
Пример
См. пример в параграфе getCurrentTarget().
getType()
Описание
Этот метод указывает на тип события.
Возвращает
- Тип — строка
stopImmediatePropagation()
Описание
Этот метод отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом.
Пример
В этом примере два прослушивателя добавляются для события ADDED к верхнему дочернему элементу в рабочей области (mc). Они оба выполняются при добавлении дочернего элемента к mc. Однако после вызова первого прослушивателя события stopImmediatePropagation() все остальные прослушиватели mc перестают получать событие (например handlerFn2). Кроме того, это предотвращает всплывание события поверх всей иерархии в рабочую область.
function handlerFn1(e) {
e.stopImmediatePropagation(); // Stops any other listeners from receiving this event
}
function handlerFn2(e) {
console.log("This will not execute");
}
var stage = player.getStage();
var mc = player.getChildAt(0);
mc.addEventListener(flwebgl.events.Event.ADDED, handlerFn1);
mc.addEventListener(flwebgl.events.Event.ADDED, handlerFn2);
stopPropagation()
Описание
Этот метод отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом.
Пример
В этом примере прослушиватель добавляется для события ADDED к верхнему дочернему элементу в рабочей области (mc). Он выполняется при добавлении дочернего элемента к mc. Кроме того, это предотвращает всплывание события поверх всей иерархии (например в рабочую область).
function handlerFn(e) {
e.stopPropagation(); // Stops the event from bubbling up the hierarchy
}
var stage = player.getStage();
var mc = player.getChildAt(0);
mc.addEventListener(flwebgl.events.Event.ADDED, handlerFn);
Вход в учетную запись