java.awt

Class EventQueue

java.lang.Object

java.awt.EventQueue

public class EventQueue
extends Object

EventQueue是一个独立于平台的类，用于从底层对等类和可信应用程序类排队事件。

它封装了从队列中提取事件，并通过调用调度它们异步事件指派机制dispatchEvent(AWTEvent)这种方法EventQueue与该事件被分派作为参数。 这种机器的特殊行为是依赖于实现的。 唯一的要求是实际排队到这个队列的事件（注意，发布到EventQueue事件可以合并）被调度：

顺序地

也就是说，不允许同时调度此队列中的几个事件。

它们排列顺序相同。

也就是说，如果AWTEvent A在AWTEvent B之前排队到EventQueue ，则事件B将不会在事件A之前调度。

一些浏览器将不同代码库中的小程序分割成单独的上下文，并在这些上下文之间建立墙壁。 在这种情况下，每个上下文将有一个EventQueue 。 其他浏览器将所有小程序放置在相同的上下文中，这意味着所有applet将只有一个全局EventQueue 。 这种行为是依赖于实现的。 有关更多信息，请参阅浏览器的文档。

有关事件调度机制的线程问题的信息，请参见AWT Threading Issues 。

从以下版本开始：

1.1

构造方法摘要

构造方法

Constructor and Description
EventQueue()

方法摘要

Modifier and Type	Method and Description
SecondaryLoop	createSecondaryLoop() 创建与此事件队列 secondary loop联的新的 secondary loop 。
protected void	dispatchEvent(AWTEvent event) 调度事件。
static AWTEvent	getCurrentEvent() 返回与调用线程 EventQueue联的EventQueue当前调度的事件。
static long	getMostRecentEventTime() 返回具有时间戳的最新事件的时间戳，并从与调用线程 EventQueue联的 EventQueue分派。
AWTEvent	getNextEvent() 从 EventQueue删除一个事件并返回。
static void	invokeAndWait(Runnable runnable) 导致 runnable的 run方法在 dispatch thread的the system EventQueue中 调用 。
static void	invokeLater(Runnable runnable) 导致 runnable在 dispatch thread的 dispatch thread中调用其 run方法。
static boolean	isDispatchThread() 如果调用线程是 the current AWT EventQueue的分派线程，则返回true。
AWTEvent	peekEvent() 返回 EventQueue上的第一个事件，而不删除它。
AWTEvent	peekEvent(int id) 返回具有指定ID的第一个事件（如果有）。
protected void	pop() 使用此 EventQueue停止调度事件。
void	postEvent(AWTEvent theEvent) 发布一个1.1风格的事件到 EventQueue 。
void	push(EventQueue newEventQueue) 替换现有 EventQueue与指定的一个。

Methods inherited from class java.lang.Object

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

构造方法详细信息

EventQueue

public EventQueue()

方法详细信息

postEvent

public void postEvent(AWTEvent theEvent)

发布一个1.1风格的事件到EventQueue 。 如果具有相同ID和事件源的队列上存在现有事件，则将调用源Component的coalesceEvents方法。

参数

theEvent -实例 java.awt.AWTEvent ，或它的子类

异常

NullPointerException - 如果 theEvent是 null

getNextEvent

public AWTEvent getNextEvent()
                      throws InterruptedException

从EventQueue中删除一个事件并返回。 此方法将阻止，直到事件已被另一个线程发布。

结果

接下来的 AWTEvent

异常

InterruptedException - 如果任何线程已经中断了这个线程

peekEvent

public AWTEvent peekEvent()

返回 EventQueue上的第一个事件，而不删除它。

结果

第一个事件

peekEvent

public AWTEvent peekEvent(int id)

返回具有指定ID的第一个事件（如果有）。

参数

id - 所需事件类型的id

结果

指定ID的第一个事件或 null如果没有这样的事件

dispatchEvent

protected void dispatchEvent(AWTEvent event)

调度事件。 事件的分派方式取决于事件的类型和事件的源对象的类型： Event Type Source Type Dispatched To ActiveEvent Any event.dispatch() Other Component source.dispatchEvent(AWTEvent) Other MenuComponent source.dispatchEvent(AWTEvent) Other Other No action (ignored)

参数

event -实例 java.awt.AWTEvent ，或它的子类

异常

NullPointerException - 如果 event是 null

从以下版本开始：

1.2

getMostRecentEventTime

public static long getMostRecentEventTime()

返回具有时间戳的最新事件的时间戳，并从与调用线程EventQueue联的EventQueue分派。 如果当前正在调度具有时间戳的事件，则会返回其时间戳。 如果没有发送任何事件，则将返回EventQueue的初始化时间。在当前版本的JDK中，只有InputEvent s， ActionEvent s和InvocationEvent具有时间戳; 然而，JDK的未来版本可能会向其他事件类型添加时间戳。 请注意，此方法只能从应用程序的event dispatching thread调用。 如果从另一个线程调用此方法，则将返回当前系统时间（由System.currentTimeMillis()报告）。

结果

的时间戳最后 InputEvent ， ActionEvent ，或 InvocationEvent被分派，或 System.currentTimeMillis()如果该方法在不同于事件指派线程的线程上调用

从以下版本开始：

1.4

另请参见：

InputEvent.getWhen() ， ActionEvent.getWhen() ， InvocationEvent.getWhen() ， isDispatchThread()

getCurrentEvent

public static AWTEvent getCurrentEvent()

返回与调用线程EventQueue联的EventQueue当前调度的事件。 如果一个方法需要对该事件的访问，但是这个方法没有被设计为接受对它的引用作为参数，这是有用的。 请注意，此方法只能从应用程序的事件调度线程调用。 如果从另一个线程调用此方法，则返回null。

结果

当前正在调度的事件，如果在除事件分派线程之外的线程上调用此方法，则为null

从以下版本开始：

1.4

push

public void push(EventQueue newEventQueue)

替换现有EventQueue与指定的一个。 任何待处理的事件都将传输到新的EventQueue进行处理。

参数

newEventQueue - 要使用的 EventQueue （或其子类）实例

异常

NullPointerException - 如果 newEventQueue是 null

从以下版本开始：

1.2

另请参见：

pop()

pop

protected void pop()
            throws EmptyStackException

停止派遣事件使用此EventQueue 。 任何待处理的事件都将转移到先前的EventQueue进行处理。

警告：为避免死锁，请勿在子类中声明此方法同步。

异常

EmptyStackException - 如果以前没有推出这个 EventQueue

从以下版本开始：

1.2

另请参见：

push(java.awt.EventQueue)

createSecondaryLoop

public SecondaryLoop createSecondaryLoop()

创建与此事件队列secondary loop联的新的secondary loop 。 使用SecondaryLoop.enter()和SecondaryLoop.exit()方法来启动和停止事件循环并从此队列调度事件。

结果

secondaryLoop一个新的辅助循环对象，可用于启动新的嵌套事件循环并从此队列调度事件

从以下版本开始：

1.7

另请参见：

SecondaryLoop.enter() ， SecondaryLoop.exit()

isDispatchThread

public static boolean isDispatchThread()

如果调用线程是the current AWT EventQueue的发送线程，则返回true。 使用此方法确保某个特定任务正在执行（或不在）。

注意：使用invokeLater(java.lang.Runnable)或invokeAndWait(java.lang.Runnable)方法在the current AWT EventQueue的发送线程中执行任务。

结果

如果在 the current AWT EventQueue的发送线程中运行， 则为 true

从以下版本开始：

1.2

另请参见：

invokeLater(java.lang.Runnable) ， invokeAndWait(java.lang.Runnable) ， Toolkit.getSystemEventQueue()

invokeLater

public static void invokeLater(Runnable runnable)

导致runnable的run方法在dispatch thread的the system EventQueue中被调用。 这将在所有待处理的事件被处理之后发生。

参数

runnable - Runnable其 run方法应该在88380062184298的 event dispatch thread中 异步执行

从以下版本开始：

1.2

另请参见：

invokeAndWait(java.lang.Runnable) ， Toolkit.getSystemEventQueue() ， isDispatchThread()

invokeAndWait

public static void invokeAndWait(Runnable runnable)
                          throws InterruptedException,
                                 InvocationTargetException

导致runnable在dispatch thread的dispatch thread中调用其run方法。 这将在所有待处理的事件被处理之后发生。 调用块直到发生这种情况。 如果从event dispatcher thread调用，此方法将抛出错误。

参数

runnable - Runnable其 run方法应在 event dispatch thread the system EventQueue中 同步执行

异常

InterruptedException - 如果有任何线程已经中断了这个线程

InvocationTargetException - 如果在运行 runnable时抛出一个 runnable

从以下版本开始：

1.2

另请参见：

invokeLater(java.lang.Runnable) ， Toolkit.getSystemEventQueue() ， isDispatchThread()