Module javafx.base

软件包 javafx.event

Class Event

java.lang.Object

java.util.EventObject

javafx.event.Event

All Implemented Interfaces:

Serializable ， Cloneable

已知直接子类：

ActionEvent ， CheckBoxTreeItem.TreeModificationEvent ， DialogEvent ， InputEvent ， ListView.EditEvent ， MediaErrorEvent ， ScrollToEvent ， SortEvent ， TableColumn.CellEditEvent ， TransformChangedEvent ， TreeItem.TreeModificationEvent ， TreeTableColumn.CellEditEvent ， TreeTableView.EditEvent ， TreeView.EditEvent ， WebErrorEvent ， WebEvent ， WindowEvent ， WorkerStateEvent

public class Event
extends EventObject
implements Cloneable

FX事件的基础类。 每个FX事件都与事件源，事件目标和事件类型相关联。 事件源为事件处理程序指定已处理该处理程序的对象以及向其发送事件的事件源。 事件目标定义了事件在发布时将行进的路径。 事件类型为同一个Event类的事件提供了额外的分类。

从以下版本开始：

JavaFX 2.0

另请参见：

Serialized Form

Field Summary

Fields

Modifier and Type	Field	描述
static EventType<Event>	ANY	所有事件类型的公共超类型。
protected boolean	consumed	此事件是否已被任何过滤器或处理程序使用。
protected EventType<? extends Event>	eventType	事件的类型。
static EventTarget	NULL_SOURCE_TARGET	表示未知事件源/目标的常数。
protected EventTarget	target	事件目标定义事件在发布时将通过的路径。

Fields inherited from class java.util.EventObject

source

构造方法摘要

构造方法

Constructor	描述
Event(Object source, EventTarget target, EventType<? extends Event> eventType)	构造一个新的 Event与指定的事件源，目标和类型。
Event(EventType<? extends Event> eventType)	构造具有指定事件类型的新的 Event 。

方法摘要

Modifier and Type	方法	描述
Object	clone()	创建并返回此 Event的副本。
void	consume()	标记为 Event消费。
Event	copyFor(Object newSource, EventTarget newTarget)	使用指定的事件源和目标创建并返回此事件的副本。
static void	fireEvent(EventTarget eventTarget, Event event)	触发指定的事件。
EventType<? extends Event>	getEventType()	获取此事件的事件类型。
EventTarget	getTarget()	返回此事件的事件目标。
boolean	isConsumed()	指示此 Event是否已被任何过滤器或处理程序使用。

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

字段详细信息

NULL_SOURCE_TARGET

public static final EventTarget NULL_SOURCE_TARGET

表示未知事件源/目标的常数。

ANY

public static final EventType<Event> ANY

所有事件类型的公共超类型。

eventType

protected EventType<? extends Event> eventType

事件的类型。

target

protected transient EventTarget target

事件目标定义事件在发布时将通过的路径。

consumed

protected boolean consumed

此事件是否已被任何过滤器或处理程序使用。

构造方法详细信息

Event

public Event(EventType<? extends Event> eventType)

构造一个具有指定事件类型的新的Event 。 事件的来源和目标设置为NULL_SOURCE_TARGET 。

参数

eventType - 事件类型

Event

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

使用指定的事件源，目标和类型构造新的Event 。 如果源或目标设置为null ，它将被替换为NULL_SOURCE_TARGET值。

参数

source - 发送事件的事件源

target - 与事件关联的事件目标

eventType - 事件类型

方法详细信息

getTarget

public EventTarget getTarget()

返回此事件的事件目标。 事件目标指定事件在发布时将行进的路径。

结果

事件目标

getEventType

public EventType<? extends Event> getEventType()

获取此事件的事件类型。 相同的对象Event类可以有不同的事件类型。 这些事件类型进一步指定发生什么样的事件。

结果

事件类型

copyFor

public Event copyFor(Object newSource,
                     EventTarget newTarget)

使用指定的事件源和目标创建并返回此事件的副本。 如果源或目标设置为null ，它将被替换为NULL_SOURCE_TARGET值。

参数

newSource - 复制事件的新来源

newTarget - 复制事件的新目标

结果

事件副本与新的源和目标

isConsumed

public boolean isConsumed()

指示此 Event是否已被任何过滤器或处理程序使用。

结果

true如果这个 Event已经消费了，其他的则是 false

consume

public void consume()

标记为Event消耗。 这样可以阻止它的进一步传播

clone

public Object clone()

创建并返回此 Event的副本。

重写：

clone在 Object

结果

一个 Event的新实例，其中所有值都从该 Event复制。

另请参见：

Cloneable

fireEvent

public static void fireEvent(EventTarget eventTarget,
                             Event event)

触发指定的事件。 给定的事件目标指定事件将通过的路径。

参数

eventTarget - 事件的目标

event - 事件发生

异常

NullPointerException - if eventTarget or event is null