java.awt
クラス EventQueue

java.lang.Object
  |
  +--java.awt.EventQueue

public class EventQueue

extends Object

EventQueue は、基本となるピアクラスと信頼できるアプリケーションクラスの両方からのイベントをキューに入れるプラットフォームに依存しないクラスです。EventQueue は、AppContext に 1 つだけです。

導入されたバージョン:

1.1

コンストラクタの概要

EventQueue()

メソッドの概要

protected void	dispatchEvent(AWTEvent event) イベントをディスパッチします。
AWTEvent	getNextEvent() EventQueue からイベントを削除し、そのイベントを返します。
static void	invokeAndWait(Runnable runnable) runnable の run() メソッドが EventQueue のディスパッチスレッドで呼び出されるようにします。
static void	invokeLater(Runnable runnable) runnable の run() メソッドが EventQueue のディスパッチスレッドで呼び出されるようにします。
static boolean	isDispatchThread() 呼び出し側スレッドが現在の 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 を、指定された EventQueue で置き換えます。

クラス 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 のインスタンス、またはそのサブクラス

getNextEvent

public AWTEvent getNextEvent()
                      throws InterruptedException

EventQueue からイベントを削除し、そのイベントを返します。このメソッドは、別のスレッドによってイベントが送信されるまでブロックされます。

戻り値:

次の AWTEvent

例外:

InterruptedException -

InterruptedException - 別のスレッドがこのスレッドに割り込んだ場合

peekEvent

public AWTEvent peekEvent()

削除せずに EventQueue の最初のイベントを返します。

戻り値:

最初のイベント

peekEvent

public AWTEvent peekEvent(int id)

指定された ID を持つイベントがある場合、その中の最初のイベントを返します。

パラメータ:

id - 要求するイベントタイプの ID

戻り値:

指定された ID を持つ最初のイベント

dispatchEvent

protected void dispatchEvent(AWTEvent event)

イベントをディスパッチします。ディスパッチ方法は、イベントのタイプおよびイベントのソースオブジェクトのタイプによって異なります。

イベントタイプ	ソースタイプ	ディスパッチ方法
ActiveEvent	Any	event.dispatch()
その他	Component	source.dispatchEvent(AWTEvent)
その他	MenuComponent	source.dispatchEvent(AWTEvent)
その他	その他	処理されない (無視される)

パラメータ:

theEvent - java.awt.AWTEvent のインスタンス、またはそのサブクラス

push

public void push(EventQueue newEventQueue)

既存の EventQueue を、指定された EventQueue で置き換えます。待ち状態のイベントは、処理のために新しい EventQueue に転送されます。

パラメータ:

an - 使用される EventQueue のインスタンス (またはそのサブクラス)

関連項目:

pop()

pop

protected void pop()
            throws EmptyStackException

この EventQueue のインスタンスを使用するイベントのディスパッチを停止します。待ち状態のイベントは、処理のために前の EventQueue に転送されます。

例外:

if - この EventQueue で以前にプッシュが行われていない場合

関連項目:

push(java.awt.EventQueue)

isDispatchThread

public static boolean isDispatchThread()

呼び出し側スレッドが現在の AWT EventQueue のディスパッチスレッドの場合に true を返します。このメソッドを使用すると、指定されたタスクを現在の AWT EventDispatchThread で確実に実行させる (または実行させない) ことができます。

戻り値:

現在の AWT EventQueue のディスパッチスレッドで動作している場合は true

invokeLater

public static void invokeLater(Runnable runnable)

runnable の run() メソッドが EventQueue のディスパッチスレッドで呼び出されるようにします。これは、待ち状態のすべてのイベントが処理されたあとに起こります。

パラメータ:

runnable - run() メソッドが EventQueue で同期で実行されなければならない Runnable

導入されたバージョン:

1.2

関連項目:

invokeAndWait(java.lang.Runnable)

invokeAndWait

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

runnable の run() メソッドが EventQueue のディスパッチスレッドで呼び出されるようにします。これは、待ち状態のすべてのイベントが処理されたあとに起こります。この呼び出しは、それが起こるまでブロックされます。このメソッドは、イベントディスパッチャスレッドから呼び出されると Error をスローします。

パラメータ:

runnable - run() メソッドが EventQueue で同期で実行されなければならない Runnable

例外:

InterruptedException - 別のスレッドがこのスレッドに割り込んだ場合

InvocationTargetException - runnable の動作中に例外がスローされる場合

導入されたバージョン:

1.2

関連項目:

invokeLater(java.lang.Runnable)