Top Description Methods
javafx.event

public Interface EventDispatchChain

Known Direct Subinterfaces
com.sun.javafx.event.EventDispatchTree
Known Direct Implementers
com.sun.javafx.event.EventDispatchChainImpl
Represents a chain of EventDispatcher objects, which can dispatch an Event. The event is dispatched by passing it from one EventDispatcher to the next in the chain until the end of chain is reached. Each EventDispatcher in the chain can influence the event path and the event itself. The chain is usually formed by following some parent - child hierarchy from the root to the event target and appending all EventDispatcher objects encountered to the chain.
Since
JavaFX 2.0

Method Summary

Modifier and TypeMethod and Description
public EventDispatchChain

Returns:

the chain with the appended event dispatcher
append(EventDispatcher
the EventDispatcher to append to the chain
eventDispatcher)

Appends the specified EventDispatcher to this chain.

public Event

Returns:

the processed event or null if the event had been fully handled / consumed
dispatchEvent(Event
the event to dispatch
event)

Dispatches the specified event through this EventDispatchChain.

public EventDispatchChain

Returns:

the chain with the prepended event dispatcher
prepend(EventDispatcher
the EventDispatcher to prepend to the chain
eventDispatcher)

Prepends the specified EventDispatcher to this chain.

Method Detail

appendback to summary
public EventDispatchChain append(EventDispatcher eventDispatcher)

Appends the specified EventDispatcher to this chain. Returns a reference to the chain with the appended element.

The caller shouldn't assume that this EventDispatchChain remains unchanged nor that the returned value will reference a different chain after the call. All this depends on the EventDispatchChain implementation.

So the call should be always done in the following form: chain = chain.append(eventDispatcher);

Parameters
eventDispatcher:EventDispatcher

the EventDispatcher to append to the chain

Returns:EventDispatchChain

the chain with the appended event dispatcher

dispatchEventback to summary
public Event dispatchEvent(Event event)

Dispatches the specified event through this EventDispatchChain. The return value represents the event after processing done by the chain. If further processing is to be done after the call the event referenced by the return value should be used instead of the original event. In the case the event is fully handled / consumed in the chain the returned value is null and no further processing should be done with that event.

Parameters
event:Event

the event to dispatch

Returns:Event

the processed event or null if the event had been fully handled / consumed

prependback to summary
public EventDispatchChain prepend(EventDispatcher eventDispatcher)

Prepends the specified EventDispatcher to this chain. Returns a reference to the chain with the prepended element.

The caller shouldn't assume that this EventDispatchChain remains unchanged nor that the returned value will reference a different chain after the call. All this depends on the EventDispatchChain implementation.

So the call should be always done in the following form: chain = chain.prepend(eventDispatcher);

Parameters
eventDispatcher:EventDispatcher

the EventDispatcher to prepend to the chain

Returns:EventDispatchChain

the chain with the prepended event dispatcher