InvocationEvent

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

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
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.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)

InvocationEvent

protected InvocationEvent(Object source,
                          int id,
                          Runnable runnable,
                          Object notifier,
                          boolean catchThrowables)

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

注意，传递无效 id 会导致不确定的行为。如果 source 为 null，则此方法抛出 IllegalArgumentException。

参数：: source - 产生事件的 Object; id - 事件的 ID; runnable - 执行其 run 方法的 Runnable; notifier - 在 Runnable.run 返回之后调用其 notifyAll 方法的 Object; catchThrowables - 指定 dispatch 是否应该在执行 Runnable 的 run 方法时捕获 Throwable，或者应该将那些 Throwable 传播到 EventDispatchThread 的调度循环中
抛出：: IllegalArgumentException - 如果 source 为 null

方法详细信息

dispatch

public void dispatch()

执行 Runnable 的 run() 方法并在 run() 返回时通知 notifier（如果有）。

指定者：: 接口 ActiveEvent 中的 dispatch

getException

public Exception getException()

返回在执行 Runnable 的 run() 方法时捕获的任何 Exception。

返回：: 如果抛出 Exception，则返回对 Exception 的引用；如果没有抛出 Exception 或者此 InvocationEvent 没有捕获异常，则返回 null

getThrowable

public Throwable getThrowable()

返回在执行 Runnable 的 run() 方法时捕获的任何 Throwable。

返回：: 如果抛出 Throwable，则返回对 Throwable 的引用；如果没有抛出 Throwable 或者此 InvocationEvent 没有捕获 Throwable，则返回 null

getWhen

public long getWhen()

返回此事件发生时的时间戳。

返回：: 此事件的时间戳
从以下版本开始：: 1.4

paramString

public String paramString()

返回标识此事件的参数字符串。此方法对事件日志记录和调试很有用。

覆盖：: 类 AWTEvent 中的 paramString

返回：: 标识事件及其属性的字符串

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。