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 로 모든 애플릿을 동작시키는 브라우저도 있습니다. 이 동작은 구현에 의해 결정됩니다. 자세한 것은 브라우저의 문서를 참조해 주세요.

도입된 버젼:

1.1

생성자의 개요

EventQueue ()

메소드의 개요

protected void	dispatchEvent (AWTEvent event) 이벤트를 디스팟치 합니다.
static AWTEvent	getCurrentEvent () 불려 간 thread에 관련지을 수 있었던 EventQueue 에 현재 디스팟치 되고 있는 이벤트를 돌려줍니다.
static long	getMostRecentEventTime () 불려 간 thread에 관련지을 수 있었던 EventQueue 로부터 디스팟치 된, 제일 새로운 타임 스탬프를 가지는 이벤트의 타임 스탬프를 돌려줍니다.
AWTEvent	getNextEvent () EventQueue 로부터 이벤트를 삭제해, 그 이벤트를 돌려줍니다.
static void	invokeAndWait (Runnable runnable) runnable 의 run 메소드가 EventQueue 의 디스팟치스렛드로 불려 가도록(듯이) 합니다.
static void	invokeLater (Runnable runnable) runnable 의 run 메소드가 EventQueue 의 디스팟치스렛드로 불려 가도록(듯이) 합니다.
static boolean	isDispatchThread () 호출측 thread가 현재의 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 로부터 이벤트를 삭제해, 그 이벤트를 돌려줍니다. 이 메소드는 다른 thread에 의해 이벤트가 송신될 때까지 블록 됩니다.

반환값:

다음의 AWTEvent

예외:

InterruptedException - 별의 thread가 이 thread에 끼어들었을 경우

peekEvent

public AWTEvent  peekEvent()

EventQueue 의 최초의 이벤트를 삭제하지 않고 돌려줍니다.

반환값:

최초의 이벤트

peekEvent

public AWTEvent  peekEvent(int id)

지정된 ID 를 가지는 이벤트가 있는 경우, 그 중의 최초의 이벤트를 돌려줍니다.

파라미터:

id - 요구하는 이벤트 타입의 ID

반환값:

지정된 ID 를 가지는 최초의 이벤트. 이 ID 를 가지는 이벤트가 존재하지 않는 경우는 null

dispatchEvent

protected void dispatchEvent(AWTEvent  event)

이벤트를 디스팟치 합니다. 디스팟치 방법은 이벤트의 타입 및 이벤트의 소스 오브젝트의 타입에 따라서 다릅니다.

이벤트 타입	소스 타입	디스팟치 방법
ActiveEvent	Any	event.dispatch()
그 외	Component	source.dispatchEvent(AWTEvent)
그 외	MenuComponent	source.dispatchEvent(AWTEvent)
그 외	그 외	처리되지 않는다 (무시된다)

getMostRecentEventTime

public static long getMostRecentEventTime()

불려 간 thread에 관련지을 수 있었던 EventQueue 로부터 디스팟치 된, 제일 새로운 타임 스탬프를 가지는 이벤트의 타임 스탬프를 돌려줍니다. 타임 스탬프를 가지는 이벤트가 디스팟치중의 경우, 그 타임 스탬프가 돌려주어집니다. 이벤트가 전혀 디스팟치되어 있지 않은 경우, EventQueue 가 초기화된 시간이 돌려주어집니다. Java platform SDK 의 현재의 버젼에서는 InputEvent,ActionEvent, 및 InvocationEvent 만이 타임 스탬프를 가집니다만, 장래의 버젼에서는 다른 이벤트 타입에도 타임 스탬프가 추가될 가능성이 있습니다. 이 메소드는 어플리케이션의 이벤트디스팟치스렛드로부터만 호출하도록 해 주세요. 다른 thread로부터 호출했을 경우,System.currentTimeMillis() 로 리포트되는 현재의 시스템 시각이 돌려주어집니다.

반환값:

디스팟치 되는 마지막 InputEvent,ActionEvent, 또는 InvocationEvent 의 타임 스탬프. 이 메소드가 이벤트디스팟치스렛드 이외로부터 불려 가는 경우는 System.currentTimeMillis()

도입된 버젼:

1.4

관련 항목:

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

getCurrentEvent

public static AWTEvent  getCurrentEvent()

불려 간 thread에 관련지을 수 있었던 EventQueue 에 현재 디스팟치 되고 있는 이벤트를 돌려줍니다. 메소드가 이벤트에 액세스 할 필요가 있어, 이벤트에의 참조를 인수로서 받도록(듯이) 설계되어 있지 않은 경우에 유효합니다. 이 메소드는 어플리케이션의 이벤트디스팟치스렛드로부터만 호출하도록 해 주세요. 다른 thread로부터 호출했을 경우, null 가 돌려주어집니다.

반환값:

현재 디스팟치 되고 있는 이벤트. 이 메소드가 이벤트디스팟치스렛드 이외의 thread로부터 불려 가고 있는 경우는 null

도입된 버젼:

1.4

push

public void push(EventQueue  newEventQueue)

기존의 EventQueue 를, 지정된 EventQueue 로 옮겨놓습니다. 대기 상태의 이벤트는 처리를 위해서(때문에) 새로운 EventQueue 에 전송 됩니다.

파라미터:

newEventQueue - 사용되는 EventQueue 또는 그 서브 클래스의 인스턴스

관련 항목:

pop()

pop

protected void pop()
            throws EmptyStackException 

이 EventQueue 를 사용하는 이벤트의 디스팟치를 정지합니다. 대기 상태의 이벤트는 처리를 위해서(때문에) 전의 EventQueue 에 전송 됩니다.

경고 - 데드 록 회피를 위해, 이 메소드를 서브 클래스에서 동기 선언하지 않게 합니다.

예외:

EmptyStackException - 이 EventQueue 로 이전에 푸쉬를 하지 않은 경우

관련 항목:

push(java.awt.EventQueue)

isDispatchThread

public static boolean isDispatchThread()

호출측 thread가 현재의 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 의 디스팟치스렛드로 불려 가도록(듯이) 합니다. 대기 상태의 모든 이벤트가 처리된 후에 실행됩니다. 호출은 이것이 실행될 때까지 블록 됩니다. 이 메소드는 이벤트 디스팻쳐 thread로부터 불려 가면(자) Error 를 슬로우 합니다.

파라미터:

runnable - run 메소드가 EventQueue 로 동기 실행되지 않으면 안 되는 Runnable

예외:

InterruptedException - 별의 thread가 이 thread에 끼어들었을 경우

InvocationTargetException - runnable 의 동작중에 예외가 슬로우 되는 경우

도입된 버젼:

1.2

관련 항목:

invokeLater(java.lang.Runnable)