Event

Поиск
Flash Professional Руководство пользователя

На этой странице

Применимо к: Flash Professional

某些 Creative Cloud 应用程序、服务和功能在中国不可用。

Описание

Класс Event используется как базовый класс для создания объектов Event, которые передаются прослушивателям событий в качестве параметров, когда происходит какое-либо событие. Методы в функциях прослушивателя событий можно использовать для изменения поведения объекта Event. Например, можно сделать текущий прослушиватель события последним в очереди на обработку событий, вызвав метод stopPropagation() или stopImmediatePropagation().

Синтаксис 

new flwebgl.events.Event(type, bubbles)

Параметры

ИмяТипОписание
тип
string
Тип события
всплывающие события
булево
Определяет присутствие объекта Event в рабочей области всплывания потока событий. Значение по умолчанию равно false

Статические свойства

ИмяТипОписание
flwebgl.events.Event.ENTER_FRAMEstringОтправляется всякий раз, когда ролик входит в кадр (до обработки анимации на временной шкале)
flwebgl.events.Event.ADDED
string
Отправляется, когда экранный элемент добавляется в качестве дочернего элемента.
flwebgl.events.Event.FRAME_CONSTRUCTEDstringОтправляется после построения текущего кадра (перед обработкой сценариев кадра).
flwebgl.events.Event.EXIT_FRAMEstringОтправляется всякий раз, когда ролик выходит из кадра (после обработки анимации на временной шкале)
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);