Java java.awt.event 类 InvocationEvent（JDK5）

所有类

概述  软件包   类  使用  树  已过时  索引  帮助
摘要： 嵌套 | 字段 | 构造方法 | 方法	详细信息： 字段 | 构造方法 | 方法

---

java.awt.event
类 InvocationEvent

java.lang.Object
  java.util.EventObject
      java.awt.AWTEvent
          java.awt.event.InvocationEvent

所有已实现的接口：

ActiveEvent, Serializable

---

public class InvocationEvent
   
   
   
   
   
extends AWTEvent
   
   
   
   
   
   
   
   
   
   
implements ActiveEvent
   
   
   
   
   

当通过 AWT 事件调度线程进行调度时，在 Runnable 上执行 run() 方法的事件。此类可以用作 ActiveEvent 的参考实现，而不用于声明新类和定义 dispatch()。

通过调用 invokeLater 和 invokeAndWait，可以将此类的实例置于 EventQueue 上。客户端代码可以使用这一事实来编写 invokeLater 和 invokeAndWait 的替代函数，无需在任何 AWTEventListener 对象中编写特殊代码。

从以下版本开始：

1.2

另请参见：

ActiveEvent, EventQueue.invokeLater(java.lang.Runnable), EventQueue.invokeAndWait(java.lang.Runnable), AWTEventListener, 序列化表格

---

字段摘要
protected  boolean	catchExceptions           如果 dispatch() 捕获了 Throwable 并将其存储在异常实例变量中，则设置为 true。
static int	INVOCATION_DEFAULT           所有 InvocationEvent 的默认 id。
static int	INVOCATION_FIRST           标记调用事件 id 范围内的第一个整数 id。
static int	INVOCATION_LAST           标记调用事件 id 范围内的最后一个整数 id。
protected  Object	notifier           在 Runnable.run() 方法返回之后立即调用其 notifyAll() 方法的对象（可能为 null）。
protected  Runnable	runnable           调用其 run() 方法的 Runnable。

 

从类 java.awt.AWTEvent 继承的字段

ACTION_EVENT_MASK, ADJUSTMENT_EVENT_MASK, COMPONENT_EVENT_MASK, consumed, CONTAINER_EVENT_MASK, FOCUS_EVENT_MASK, HIERARCHY_BOUNDS_EVENT_MASK, HIERARCHY_EVENT_MASK, id, INPUT_METHOD_EVENT_MASK, INVOCATION_EVENT_MASK, ITEM_EVENT_MASK, KEY_EVENT_MASK, MOUSE_EVENT_MASK, MOUSE_MOTION_EVENT_MASK, MOUSE_WHEEL_EVENT_MASK, PAINT_EVENT_MASK, RESERVED_ID_MAX, TEXT_EVENT_MASK, WINDOW_EVENT_MASK, WINDOW_FOCUS_EVENT_MASK, WINDOW_STATE_EVENT_MASK

 

从类 java.util.EventObject 继承的字段
source

 

构造方法摘要
protected	InvocationEvent(Object source, int id, Runnable runnable, Object notifier, boolean catchThrowables)           构造一个具有指定源和 ID 的 InvocationEvent，此源和 ID 将在被指派时执行 runnable 的 run 方法。
	InvocationEvent(Object source, Runnable runnable)           构造一个具有指定源的 InvocationEvent，此源将在被指派时执行 runnable 的 run 方法。
	InvocationEvent(Object source, Runnable runnable, Object notifier, boolean catchThrowables)           构造一个具有指定源的 InvocationEvent，此源将在被指派时执行 runnable 的 run 方法。

 

方法摘要
void	dispatch()           执行 Runnable 的 run() 方法并在 run() 返回时通知 notifier（如果有）。
Exception	getException()           返回在执行 Runnable 的 run() 方法时捕获的任何 Exception。
Throwable	getThrowable()           返回在执行 Runnable 的 run() 方法时捕获的任何 Throwable。
long	getWhen()           返回此事件发生时的时间戳。
String	paramString()           返回标识此事件的参数字符串。

 

从类 java.awt.AWTEvent 继承的方法
consume, getID, isConsumed, setSource, toString

 

从类 java.util.EventObject 继承的方法
getSource

 

从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

 

字段详细信息

INVOCATION_FIRST

public static final int INVOCATION_FIRST

标记调用事件 id 范围内的第一个整数 id。

另请参见：

常量字段值

---

INVOCATION_DEFAULT

public static final int INVOCATION_DEFAULT

所有 InvocationEvent 的默认 id。

另请参见：

常量字段值

---

INVOCATION_LAST

public static final int INVOCATION_LAST

标记调用事件 id 范围内的最后一个整数 id。

另请参见：

常量字段值

---

runnable

protected Runnable runnable

调用其 run() 方法的 Runnable。

---

notifier

protected Object notifier

在 Runnable.run() 方法返回之后立即调用其 notifyAll() 方法的对象（可能为 null）。

---

catchExceptions

protected boolean catchExceptions

如果 dispatch() 捕获了 Throwable 并将其存储在异常实例变量中，则设置为 true。如果设置为 false，则会将 Throwable 传播到 EventDispatchThread 的调度循环中。

构造方法详细信息

InvocationEvent

public InvocationEvent(Object source,
                       Runnable runnable)

构造一个具有指定源的 InvocationEvent，此源将在被指派时执行 runnable 的 run 方法。

这是一个很有用的构造方法。对于 InvocationEvent(source, runnable) 形式的调用而言，其行为与调用 InvocationEvent(source, runnable, null, false) 完全相同。

如果 source 为 null，则此方法抛出 IllegalArgumentException。

参数：

source - 产生事件的 Object

runnable - 执行其 run 方法的 Runnable

抛出：

IllegalArgumentException - 如果 source 为 null

另请参见：

InvocationEvent(Object, Runnable, Object, boolean)

---

InvocationEvent

public InvocationEvent(Object source,
                       Runnable runnable,
                       Object notifier,
                       boolean catchThrowables)

构造一个具有指定源的 InvocationEvent，此源将在被指派时执行 runnable 的 run 方法。如果 notifier 为非 null，则会在 run 返回之后立即对它调用 notifyAll()。

对于 InvocationEvent(source, runnable, notifier, catchThrowables) 形式的调用而言，其行为与调用 InvocationEvent(source, InvocationEvent.INVOCATION_DEFAULT, runnable, notifier, catchThrowables) 完全相同。

如果 source 为 null，则此方法抛出 IllegalArgumentException。

参数：

source - 产生事件的 Object

runnable - 执行其 run 方法的 Runnable

notifier - 在 Runnable.run 返回之后调用其 notifyAll 方法的对象

catchThrowables - 指定 dispatch 是否应该在执行 Runnable 的 run 方法时捕获 Throwable，或者应该将那些 Throwable 传播到 EventDispatchThread 的调度循环中

抛出：

IllegalArgumentException - 如果 source 为 null

另请参见：

InvocationEvent(Object, int, Runnable, Object, boolean)