Интерфейс EventDispatchChain

public interface EventDispatchChain

• Краткое описание методов

  Все методыМетоды экземпляраАбстрактные методы

  Модификатор и тип	Метод и описание
  EventDispatchChain	append(EventDispatcher eventDispatcher) Добавляет указанный объект в конец этой цепочки.
  Event	dispatchEvent(Event event) Обрабатывает указанное событие через эту цепочку.
  EventDispatchChain	prepend(EventDispatcher eventDispatcher) Добавляет указанный объект в начало этой цепочки.

• Подробное описание методов

  • append

    EventDispatchChain append(EventDispatcher eventDispatcher)

    Добавляет указанный объект в конец этой цепочки. Возвращает ссылку на цепочку с добавленным элементом.

    Вызывающий код не должен полагаться на то, что эта цепочка останется неизменной, или что возвращаемое значение будет ссылаться на другую цепочку после вызова. Всё это зависит от реализации объекта.

    Поэтому вызов всегда должен выполняться в следующем формате: chain = chain.append(eventDispatcher);

    Параметры:

    eventDispatcher - объект, который необходимо добавить в цепочку

    Возвращает:

    цепочку с добавленным обработчиком событий

  • prepend

    EventDispatchChain prepend(EventDispatcher eventDispatcher)

    Добавляет указанный объект в начало этой цепочки. Возвращает ссылку на цепочку с добавленным элементом.

    Вызывающий код не должен полагаться на то, что эта цепочка останется неизменной, или что возвращаемое значение будет ссылаться на другую цепочку после вызова. Всё это зависит от реализации объекта.

    Поэтому вызов всегда должен выполняться в следующем формате: chain = chain.prepend(eventDispatcher);

    Параметры:

    eventDispatcher - объект, который необходимо добавить в начало цепочки

    Возвращает:

    цепочку с добавленным обработчиком событий

  • dispatchEvent

    Event dispatchEvent(Event event)

    Обрабатывает указанное событие через эту цепочку. Возвращаемое значение представляет событие после обработки цепочкой. Если дальнейшая обработка должна быть выполнена после вызова, необходимо использовать событие, на которое ссылается возвращаемое значение, вместо исходного события. В случае, если событие полностью обработано/поглощено в цепочке, возвращаемое значение является null, и дальнейшая обработка этого события не должна выполняться.

    Параметры:

    event - событие для обработки

    Возвращает:

    обработанное событие или null, если событие было полностью обработано/поглощено