java.awt
인터페이스 KeyEventDispatcher

알려진 구현 클래스 목록:

DefaultFocusManager, DefaultKeyboardFocusManager, FocusManager, KeyboardFocusManager

public interface KeyEventDispatcher

KeyEventDispatcher 은 모든 KeyEvents 타겟 지정과 디스패치에 관해서 현재의 KeyboardFocusManager와 협력합니다. 현재의 KeyboardFocusManager에 의해 등록된 KeyEventDispatchers는 각각의 타겟이 디스패치 되기 전에 KeyEvents를 받습니다. 이것에 의해 각 KeyEventDispatcher는 이벤트의 타겟의 재지정, 소비, 이벤트 자체의 디스패치, 또는 그 외의 변경을 실시할 수 있습니다 .

KeyboardFocusManager 자체가 KeyEventDispatcher를 구현하는 것에 주의해 주세요. 디폴트로 현재의 KeyboardFocusManager는 등록된 KeyEventDispatchers에 의해 디스패치 되지 않는 모든 KeyEvents 세면대가 됩니다. 현재의 KeyboardFocusManager는 KeyEventDispatcher로서의 등록을 완전하게 해제할 수 없습니다. 다만, KeyEventDispatcher가 실제로 디스패치 했는지 어떠했는지에 관계없이 KeyEvent를 디스패치 한 것을 보고하는 경우는 KeyboardFocusManager는 KeyEvent에 관해서 그 이상의 처리는 실시하지 않습니다 (클라이언트 코드는 현재의 KeyboardFocusManager를 KeyEventDispatcher 로서 1회 이상 등록하는 것은 가능하지만, 보통 이것은 불필요하고, 추천하지 않습니다).

도입된 버전 :

1.4

관련 항목:

KeyboardFocusManager.addKeyEventDispatcher(java.awt.KeyEventDispatcher), KeyboardFocusManager.removeKeyEventDispatcher(java.awt.KeyEventDispatcher)

메서드 개요

boolean

dispatchKeyEvent (KeyEvent e) 이 메서드는 현재의 KeyboardFocusManager에 의해 불려가 이 KeyEventDispatcher가 그 메서드 대신에 지정된 이벤트를 디스패치 하도록 요구합니다.

메서드의 상세

dispatchKeyEvent

boolean dispatchKeyEvent(KeyEvent  e)

이 메서드는 현재의 KeyboardFocusManager에 의해 불려가 이 KeyEventDispatcher가 그 메서드 대신에 지정된 이벤트를 디스패치 하도록 요구합니다. 이 KeyEventDispatcher는 자유롭게 이벤트의 타겟의 재지정, 이벤트의 소비, 이벤트 자체의 디스패치, 또는 그 외의 변경을 실시할 수 있습니다 . 보통, 이 기능은 KeyEvents를 포커스의 소유자 이외의 Components에 송신하기 위해서 사용됩니다. 이것은 예를 들어 액세스 가능한 환경에 있어 포커스 불가능한 Windows 자식을 안내할 경우에 도움이 됩니다. KeyEventDispatcher가 KeyEvent 자체를 디스패치 하는 경우는 redispatchEvent를 사용해, 현재의 KeyboardFocusManager에 대해서 이 KeyEventDispatcher가 재차 이벤트의 디스패치를 재귀적으로 요구하지 않게의해 주세요.

이 메서드의 구현이 false를 돌려주는 경우, KeyEvent는 체인의 다음의 KeyEventDispatcher 에게 건네져 현재의 KeyboardFocusManager 로 종료합니다. 구현이 true를 돌려주는 경우, KeyEvent는 디스패치 된 것이라고 보여지고 (실제로 디스패치 될 필요는 없다), 현재의 KeyboardFocusManager는 KeyEvent에 관해서 더 이상의 처리를 실시하지 않습니다. 이러한 경우 KeyboardFocusManager.dispatchEvent는 다음과 같이 true를 리턴합니다. 구현이 KeyEvent를 소비하는 것에도 불구하고 false를 돌려주는 경우, 소비된 이벤트는 더 체인의 다음의 KeyEventDispatcher 에게 건네집니다. 개발자는 KeyEvent가 타겟이 디스패치 되기 전에 소비되고 있는지를 체크하는 것이 중요합니다. 디폴트에서는 현재의 KeyboardFocusManager는 소비된 KeyEvent를 디스패치 할 것은 없습니다.

파라미터:

e - 디스패치 하는 KeyEvent

반환값:

KeyboardFocusManager가 KeyEvent에 관해서 더 이상의 처리를 실시하지 않는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

KeyboardFocusManager.redispatchEvent(java.awt.Component, java.awt.AWTEvent)