java.awt

クラスEventQueue

java.lang.Object

java.awt.EventQueue

public class EventQueue
extends Object

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

キューからイベントを抽出する非同期イベント・ディスパッチ機構をカプセル化し、ディスパッチされるイベントを引数としてEventQueueのdispatchEvent(AWTEvent)メソッドを呼び出すことによりディスパッチします。実際の動作は実装によって異なります。唯一の要件は、このキュー(EventQueueに送られたイベントは合体できる)に実際に入れられたイベントをディスパッチすることです。

順次

これが指定されている場合、このキューの複数イベントの同時ディスパッチは許可されません。

キューに入れられた順序

AWTEvent AがAWTEvent Bよりも前にEventQueueに入れられた場合、イベントBをイベントAよりも前にディスパッチすることはできません。

一部のブラウザは、異なるコード・ベースのアプレットを別のコンテキストに分割し、これらのコンテキストの間に壁を構築します。この場合、各コンテキストごとに1つのEventQueueが存在することになります。すべてのアプレットを同じコンテキストに置き、1つのグローバルEventQueueですべてのアプレットを動作させるブラウザもあります。この動作は実装に依存します。詳細はブラウザのマニュアルを参照してください。

イベント・ディスパッチ機能のスレッド問題については「AWTのスレッドの問題」を参照してください。

導入されたバージョン:

1.1

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
EventQueue()

メソッドのサマリー

修飾子と型	メソッドと説明
SecondaryLoop	createSecondaryLoop() このイベント・キューに関連付けられた新しいsecondary loopを作成します。
protected void	dispatchEvent(AWTEvent event) イベントをディスパッチします。
static AWTEvent	getCurrentEvent() 呼出し元スレッドに関連付けられたEventQueueによって現在ディスパッチされているイベントを返します。
static long	getMostRecentEventTime() タイムスタンプを含み、呼出し元スレッドに関連付けられたEventQueueからディスパッチされた最新のイベントのタイムスタンプを返します。
AWTEvent	getNextEvent() EventQueueからイベントを削除し、そのイベントを返します。
static void	invokeAndWait(Runnable runnable) runnableのrunメソッドがthe system EventQueueのdispatch threadで呼び出されるようにします。
static void	invokeLater(Runnable runnable) runnableのrunメソッドがthe system EventQueueのdispatch threadで呼び出されるようにします。
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を指定されたものに置き換えます。

クラス 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を持つ最初のイベント。このIDを持つイベントが存在しない場合はnull

dispatchEvent

protected void dispatchEvent(AWTEvent event)

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

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

パラメータ:

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

例外:

NullPointerException - eventがnullの場合

導入されたバージョン:

1.2

getMostRecentEventTime

public static long getMostRecentEventTime()

タイムスタンプを含み、呼出し元スレッドに関連付けられたEventQueueからディスパッチされた最新のイベントのタイムスタンプを返します。タイムスタンプを持つイベントがディスパッチ中の場合、そのタイムスタンプが返されます。イベントがまったくディスパッチされていない場合、EventQueueが初期化された時間が返されます。JDKの現在のバージョンでは、InputEvent、ActionEvent、およびInvocationEventだけがタイムスタンプを持ちますが、将来のバージョンではほかのイベント型にもタイムスタンプが追加される可能性があります。このメソッドはアプリケーションのイベント・ディスパッチ・スレッドからのみ呼び出すようにしてください。ほかのスレッドから呼び出した場合、System.currentTimeMillis()でレポートされる現在のシステム時刻が返されます。

戻り値:

ディスパッチされる、最後のInputEvent、ActionEvent、またはInvocationEventのタイムスタンプ。このメソッドがイベント・ディスパッチ・スレッド以外のスレッドから呼び出される場合はSystem.currentTimeMillis()

導入されたバージョン:

1.4

関連項目:

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

getCurrentEvent

public static AWTEvent getCurrentEvent()

呼出し元スレッドに関連付けられた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を作成します。イベント・ループの開始と停止を行い、このキューからイベントをディスパッチするには、SecondaryLoop.enter()メソッドとSecondaryLoop.exit()メソッドを使用します。

戻り値:

新しいセカンダリ・ループ・オブジェクトsecondaryLoop。ネストされた新しいイベント・ループを起動し、このキューからイベントをディスパッチするために使用できる

導入されたバージョン:

1.7

関連項目:

SecondaryLoop.enter(), SecondaryLoop.exit()

isDispatchThread

public static boolean isDispatchThread()

呼出し元スレッドがthe current AWT EventQueueのディスパッチ・スレッドである場合はtrueを返します。特定のタスクが実行されている(または実行されていない)ことを確認するには、このメソッドを使用します。

注: the current AWT EventQueueのディスパッチ・スレッドでタスクを実行するには、invokeLater(java.lang.Runnable)メソッドまたはinvokeAndWait(java.lang.Runnable)メソッドを使用します。

戻り値:

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メソッドがthe system EventQueueのdispatch threadで呼び出されるようにします。待ち状態のすべてのイベントが処理されたあとで実行されます。

パラメータ:

runnable - runメソッドがthe system EventQueueのevent dispatch threadで非同期に実行されなければならないRunnable

導入されたバージョン:

1.2

関連項目:

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

invokeAndWait

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

runnableのrunメソッドがthe system EventQueueのdispatch threadで呼び出されるようにします。待ち状態のすべてのイベントが処理されたあとで実行されます。呼出しはこれが実行されるまでブロックされます。このメソッドは、event dispatcher threadから呼び出されるとErrorをスローします。

パラメータ:

runnable - runメソッドがthe system EventQueueのevent dispatch threadで同期で実行されなければならないRunnable

例外:

InterruptedException - いずれかのスレッドがこのスレッドに割り込んだ場合

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

導入されたバージョン:

1.2

関連項目:

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