Package com.luciad.input

Class TLcdAWTEventDispatcher

java.lang.Object

com.luciad.input.TLcdAWTEventDispatcher

All Implemented Interfaces:

ILcdAWTEventListener, ILcdAWTEventSource

public class TLcdAWTEventDispatcher
extends Object
implements ILcdAWTEventListener, ILcdAWTEventSource

This class is the central access point for dispatching AWTEvent (extensions) and informing all interested parties about it.

Events are dispatched to their source when this source is an instance of Component.

Typically this source will be the most specific component matching with the event. For example, for a touch event this could be the deepest component overlapping with the touch coordinates.

Listeners can be added to this class which will be warned when an event is dispatched. This allows to listen to all events which are inserted into the application.

 // add our listener to the dispatcher
 aEventDispatcher.addEventListener( new ILcdAWTEventListener(){
   public void handleAWTEvent( AWTEvent aEvent ) {
       // do something with the event
   } };
  

This is especially useful for debugging purposes.

All methods should be called from the Event Dispatch Thread (EDT).

Since:

10.0

Method Summary

Modifier and Type	Method	Description
void	addAWTEventListener(ILcdAWTEventListener aEventListener)	Register an AWTEventListener which will be informed every time an event is dispatched into the application using this TLcdAWTEventDispatcher.
static TLcdAWTEventDispatcher	getInstance()	Returns a static instance of TLcdAWTEventDispatcher.
void	handleAWTEvent(AWTEvent aEvent)	Dispatches an event, and inform all registered listeners about the event.
void	removeAWTEventListener(ILcdAWTEventListener aEventListener)	Remove an AWTEventListener which was added previously so it will no longer be informed about events which are dispatched into the application.

Methods inherited from class java.lang.Object

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

Method Details

getInstance

public static TLcdAWTEventDispatcher getInstance()

Returns a static instance of TLcdAWTEventDispatcher. This technique is known as the singleton pattern.

Returns:

the common instance of TLcdAWTEventDispatcher.

handleAWTEvent

public void handleAWTEvent(AWTEvent aEvent)

Dispatches an event, and inform all registered listeners about the event.

The event is directly dispatched to its source.

Specified by:

handleAWTEvent in interface ILcdAWTEventListener

Parameters:

aEvent - the event to dispatch. Only AWTEvent of which the source is an instance of Component are dispatched.

See Also:

• addAWTEventListener(ILcdAWTEventListener)

addAWTEventListener

public void addAWTEventListener(ILcdAWTEventListener aEventListener)

Register an AWTEventListener which will be informed every time an event is dispatched into the application using this TLcdAWTEventDispatcher.

Specified by:

addAWTEventListener in interface ILcdAWTEventSource

Parameters:

aEventListener - the listener

See Also:

• removeAWTEventListener(ILcdAWTEventListener)

removeAWTEventListener

public void removeAWTEventListener(ILcdAWTEventListener aEventListener)

Remove an AWTEventListener which was added previously so it will no longer be informed about events which are dispatched into the application.

Specified by:

removeAWTEventListener in interface ILcdAWTEventSource

Parameters:

aEventListener - the listener

See Also:

• addAWTEventListener(ILcdAWTEventListener)