com.google.appinventor.components.runtime

Class EventDispatcher

java.lang.Object

com.google.appinventor.components.runtime.EventDispatcher

public class EventDispatcher
extends java.lang.Object

Dispatches events to component event handlers.

Method Summary

Methods

Modifier and Type	Method and Description
static boolean	dispatchEvent(Component component, java.lang.String eventName, java.lang.Object... args) Dispatches an event based on its name to any registered handlers.
static java.lang.String	makeFullEventName(java.lang.String componentId, java.lang.String eventName)
static void	registerEventForDelegation(HandlesEventDispatching dispatchDelegate, java.lang.String componentId, java.lang.String eventName) Registers a dispatchDelegate for handling event dispatching for the event with the specified component id and event name.
static void	removeDispatchDelegate(HandlesEventDispatching dispatchDelegate) Removes event handlers previously registered with the given dispatchDelegate and clears all references to the dispatchDelegate in this class.
static void	unregisterAllEventsForDelegation() Removes all event closures previously registered via registerEventForDelegation(com.google.appinventor.components.runtime.HandlesEventDispatching, java.lang.String, java.lang.String).
static void	unregisterEventForDelegation(HandlesEventDispatching dispatchDelegate, java.lang.String componentId, java.lang.String eventName) Unregisters a dispatchDelegate for handling event dispatching for the event with the specified component id and event name.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

registerEventForDelegation

public static void registerEventForDelegation(HandlesEventDispatching dispatchDelegate,
                              java.lang.String componentId,
                              java.lang.String eventName)

Registers a dispatchDelegate for handling event dispatching for the event with the specified component id and event name.

Parameters:

dispatchDelegate - object responsible for dispatching the event

componentId - id of component associated with event handler

eventName - name of event

unregisterEventForDelegation

public static void unregisterEventForDelegation(HandlesEventDispatching dispatchDelegate,
                                java.lang.String componentId,
                                java.lang.String eventName)

Unregisters a dispatchDelegate for handling event dispatching for the event with the specified component id and event name.

Parameters:

dispatchDelegate - object responsible for dispatching the event

componentId - id of component associated with event handler

eventName - name of event

unregisterAllEventsForDelegation

public static void unregisterAllEventsForDelegation()

Removes all event closures previously registered via registerEventForDelegation(com.google.appinventor.components.runtime.HandlesEventDispatching, java.lang.String, java.lang.String).

removeDispatchDelegate

public static void removeDispatchDelegate(HandlesEventDispatching dispatchDelegate)

Removes event handlers previously registered with the given dispatchDelegate and clears all references to the dispatchDelegate in this class. Called when a Form's onDestroy method is called.

dispatchEvent

public static boolean dispatchEvent(Component component,
                    java.lang.String eventName,
                    java.lang.Object... args)

Dispatches an event based on its name to any registered handlers.

Parameters:

component - the component raising the event

eventName - name of event being raised

args - arguments to the event handler

makeFullEventName

public static java.lang.String makeFullEventName(java.lang.String componentId,
                                 java.lang.String eventName)