Interface EventDispatcherInterface

The EventDispatcherInterface interface is the 3djuump infinite API implementation of the observer pattern, very similar to the DOM event system of javascript.

Objects implementing this interface can install/remove listeners to be notified when some events fire with the use of the addEventListener and removeEventListener functions.

/** 
 * Sample to illustrate how to use the 3djuump infinite signal system.
 */
import { FilterItemInterface, FilterItemInterfaceSignal } from 'generated/documentation/appinfiniteapi';

// filter has been created previously
let lFilter : FilterItemInterface;

// we want to be notified when events occur
const lCallbackId : string = lFilter.addEventListener(FilterItemInterfaceSignal.FilterChanged, (_event: any, _pObject: Object | undefined) =>
{
    // output a fancy message when filter changes
    console.log('filter has changed');
    // and remove the listener
    lFilter.removeEventListenerById(lCallbackId);
});

The syntax is very close to the DOM addEventlistener functions.
Events

Hierarchy

Methods

addEventListener hasEventListener removeAllEventListeners removeEventListener removeEventListenerById

Methods

addEventListener

  • Adds a listener to an event type.

    When an event of the type pType fires, the callback pListener will be called. This function returns a unique string id that may be used in removeEventListenerById to allow simple listener removal. It is possible to add an object that will be included in the callback to avoid creating too many closures.

    Returns

    The id of the inserted callback (actually an UUID).

    Parameters

    • pType: string
      in
      The type of the event pListener will be called upon.
    • pListener: tListenerCallback
      in
      The listener function that fires when the given event type occurs.
    • pObject: undefined | Object
      in
      The optional object the callback will be called with when the given event fires.

    Returns string

  • Adds a listener to an event type.

    When an event of the type pType fires, the callback pListener will be called. This function returns a unique string id that may be used in removeEventListenerById to allow simple listener removal.

    Returns

    The id of the inserted callback (actually an UUID).

    Parameters

    • pType: string
      in
      The type of the event pListener will be called upon.
    • pListener: tListenerCallback
      in
      The listener function that fires when the given event type occurs.

    Returns string

hasEventListener

  • Tells if the EventDispatcher has such a callback registered for the given event type.

    Returns

    true if such a listener is installed for the given type of event.

    Parameters

    • pType: string
      in
      The type of the event to test.
    • pListener: tListenerCallback
      in
      The listener function that gets tested.

    Returns boolean

removeAllEventListeners

  • Removes all the event listeners.

    Returns

    true if all the callbacks were removed else false.

    Returns boolean

removeEventListener

  • Removes a listener from an event type.

    If no such listener is found, then the function returns false and does nothing. You must use the exact parameters that were used in addEventListener to actually remove the listener.

    Returns

    true if the callback was removed else false.

    Parameters

    • pType: string
      in
      The type of the listener that gets removed.
    • pListener: tListenerCallback

      The listener function that gets removed.

    • pObject: undefined | Object

      The listener object that was used when addEventListener was called.

    Returns boolean

  • Removes a listener from an event type.

    If no such listener is found, then the function returns false and does nothing. You must use the exact parameters that were used in addEventListener to actually remove the listener.

    Returns

    true if the callback was removed else false.

    Parameters

    • pType: string
      in
      The type of the listener that gets removed.
    • pListener: tListenerCallback

      The listener function that gets removed.

    Returns boolean

removeEventListenerById

  • Removes a listener by its id.

    If no such listener is found, then the function returns false and does nothing. You must use the return value of addEventListener to actually remove the listener.

    Returns

    true if the callback was removed else false.

    Parameters

    • pId: string
      in
      The id returned by the call to [addEventListener](EventDispatcherInterface.html#addEventListener) that you want to remove.

    Returns boolean

Settings

Member Visibility

Theme