javafx.event

Class Event

java.lang.Object

java.util.EventObject

javafx.event.Event

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable

Direct Known Subclasses:

ActionEvent

public class Event
extends java.util.EventObject
implements java.lang.Cloneable

Base class for FX events. Each FX event has associated an event source, event target and an event type. The event source specifies for an event handler the object on which that handler has been registered and which sent the event to it. The event target defines the path through which the event will travel when posted. The event type provides additional classification to events of the same Event class.

Since:

JavaFX 2.0

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static EventType<Event>	ANY Common supertype for all event types.
protected boolean	consumed Whether this event has been consumed by any filter or handler.
protected EventType<? extends Event>	eventType Type of the event.
static EventTarget	NULL_SOURCE_TARGET The constant which represents an unknown event source / target.
private static long	serialVersionUID
protected EventTarget	target Event target that defines the path through which the event will travel when posted.

Fields inherited from class java.util.EventObject

source

Constructor Summary

Constructors

Constructor and Description
Event(EventType<? extends Event> eventType) Construct a new Event with the specified event type.
Event(java.lang.Object source, EventTarget target, EventType<? extends Event> eventType) Construct a new Event with the specified event source, target and type.

Method Summary

Modifier and Type	Method and Description
java.lang.Object	clone() Creates and returns a copy of this Event.
void	consume() Marks this Event as consumed.
Event	copyFor(java.lang.Object newSource, EventTarget newTarget) Creates and returns a copy of this event with the specified event source and target.
static void	fireEvent(EventTarget eventTarget, Event event) Fires the specified event.
EventType<? extends Event>	getEventType() Gets the event type of this event.
EventTarget	getTarget() Returns the event target of this event.
boolean	isConsumed() Indicates whether this Event has been consumed by any filter or handler.
private void	readObject(java.io.ObjectInputStream in)

Methods inherited from class java.util.EventObject

getSource, toString

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

NULL_SOURCE_TARGET

public static final EventTarget NULL_SOURCE_TARGET

The constant which represents an unknown event source / target.

ANY

public static final EventType<Event> ANY

Common supertype for all event types.

eventType

protected EventType<? extends Event> eventType

Type of the event.

target

protected transient EventTarget target

Event target that defines the path through which the event will travel when posted.

consumed

protected boolean consumed

Whether this event has been consumed by any filter or handler.

Constructor Detail

Event

public Event(EventType<? extends Event> eventType)

Construct a new Event with the specified event type. The source and target of the event is set to NULL_SOURCE_TARGET.

Parameters:

eventType - the event type

Event

public Event(java.lang.Object source,
             EventTarget target,
             EventType<? extends Event> eventType)

Construct a new Event with the specified event source, target and type. If the source or target is set to null, it is replaced by the NULL_SOURCE_TARGET value.

Parameters:

source - the event source which sent the event

target - the event target to associate with the event

eventType - the event type

Method Detail

getTarget

public EventTarget getTarget()

Returns the event target of this event. The event target specifies the path through which the event will travel when posted.

Returns:

the event target

getEventType

public EventType<? extends Event> getEventType()

Gets the event type of this event. Objects of the same Event class can have different event types. These event types further specify what kind of event occurred.

Returns:

the event type

copyFor

public Event copyFor(java.lang.Object newSource,
                     EventTarget newTarget)

Creates and returns a copy of this event with the specified event source and target. If the source or target is set to null, it is replaced by the NULL_SOURCE_TARGET value.

Parameters:

newSource - the new source of the copied event

newTarget - the new target of the copied event

Returns:

the event copy with the new source and target

isConsumed

public boolean isConsumed()

Indicates whether this Event has been consumed by any filter or handler.

Returns:

true if this Event has been consumed, false otherwise

consume

public void consume()

Marks this Event as consumed. This stops its further propagation.

clone

public java.lang.Object clone()

Creates and returns a copy of this Event.

Overrides:

clone in class java.lang.Object

Returns:

a new instance of Event with all values copied from this Event.

readObject

private void readObject(java.io.ObjectInputStream in)
                 throws java.io.IOException,
                        java.lang.ClassNotFoundException

Throws:

java.io.IOException

java.lang.ClassNotFoundException

fireEvent

public static void fireEvent(EventTarget eventTarget,
                             Event event)

Fires the specified event. The given event target specifies the path through which the event will travel.

Parameters:

eventTarget - the target for the event

event - the event to fire

Throws:

java.lang.NullPointerException - if eventTarget or event is null