java.awt
클래스 KeyboardFocusManager

java.lang.Object 
  java.awt.KeyboardFocusManager

모든 구현된 인터페이스:

KeyEventDispatcher, KeyEventPostProcessor

알려진 직계 서브 클래스:

DefaultKeyboardFocusManager

public abstract class KeyboardFocusManager
extends Object 
implements KeyEventDispatcher,
 KeyEventPostProcessor 

KeyboardFocusManager는 액티브가 되어 포커스 된 Window 및 현재의 포커스의 소유자의 관리를 제어합니다. 포커스의 소유자는 보통 사용자에 의해 생성되는 모든 KeyEvents를 받는 어플리케이션의 Component 로서 정의됩니다. 포커스 된 Window는 포커스의 소유자이든가 또는 포커스의 소유자를 포함한 Window 입니다. Frame 또는 Dialog 만이 액티브 Window 입니다. 네이티브인 윈도우 처리 시스템은 액티브 Window 또는 하이라이트 된 타이틀 바 등 특별한 장식을 가지는 그 자식을 나타냅니다. 액티브 Window는 항상, 포커스 된 Window 인가 또는 포커스 된 Window 소유자인 최초의 Frame 또는 Dialog 머지않아인가입니다.

KeyboardFocusManager는 클라이언트 코드가 포커스의 소유자를 조회해, 포커스의 변경을 개시하는 중앙 배치의 로케이션이며, 포커스에 관련된 모든 FocusEvents, WindowEvents 및 KeyEvents 이벤트 디스팻쳐입니다.

일부의 브라우저는 다른 코드 베이스의 애플릿을 다른 컨텍스트에 분할해, 이러한 컨텍스트 의 사이에 벽을 구축합니다. 이러한 시나리오에서는 컨텍스트 마다 1개의 KeyboardFocusManager가 있습니다. 다른 브라우저는 모든 애플릿을 같은 컨텍스트에 배치합니다. 이것은 모든 애플릿에 대해서 단일로 글로벌인 KeyboardFocusManager 만이 있는 것을 나타냅니다. 이 동작은 구현에 의존합니다. 자세한 것은 브라우저의 메뉴얼을 참조하십시오. 다만, 존재하는 컨텍스트 의 수에 관계없이, ClassLoader 근처 복수의 포커스의 소유자, 포커스 된 Window, 또는 액티브 Window가 존재할 것은 없습니다.

상세한 것에 대하여는 「The Java Tutorial」의 「How to Use the Focus Subsystem」 및「Focus Specification」 를 참조하십시오.

도입된 버전 :

1.4

관련 항목:

Window, Frame, Dialog, FocusEvent, WindowEvent, KeyEvent

필드 개요

static int	BACKWARD_TRAVERSAL_KEYS Backward 포커스 traversal 키의 식별자입니다.
static int	DOWN_CYCLE_TRAVERSAL_KEYS Down Cycle 포커스 traversal 키의 식별자입니다.
static int	FORWARD_TRAVERSAL_KEYS Forward 포커스 traversal 키의 식별자입니다.
static int	UP_CYCLE_TRAVERSAL_KEYS Up Cycle 포커스 traversal 키의 식별자입니다.

생성자 개요

KeyboardFocusManager ()
KeyboardFocusManager를 초기화합니다.

메서드 개요

void	addKeyEventDispatcher (KeyEventDispatcher dispatcher) KeyEventDispatcher를 이 KeyboardFocusManager 디스팻쳐 체인에 추가합니다.
void	addKeyEventPostProcessor (KeyEventPostProcessor processor) 이 KeyboardFocusManager 포스트프로세서 체인에 KeyEventPostProcessor를 추가합니다.
void	addPropertyChangeListener (PropertyChangeListener listener) PropertyChangeListener를 리스너 리스트에 추가합니다.
void	addPropertyChangeListener (String propertyName, PropertyChangeListener listener) 특정의 프로퍼티의 리스너 리스트에 PropertyChangeListener를 추가합니다.
void	addVetoableChangeListener (String propertyName, VetoableChangeListener listener) 특정의 프로퍼티의 리스너 리스트에 VetoableChangeListener를 추가합니다.
void	addVetoableChangeListener (VetoableChangeListener listener) VetoableChangeListener를 리스너 리스트에 추가합니다.
void	clearGlobalFocusOwner () Java 및 네이티브 레벨의 양쪽 모두로 글로벌 포커스의 소유자를 클리어 합니다.
protected abstract void	dequeueKeyEvents (long after, Component untilFocused) 지연 한 KeyEvents 디스패치를 취소하도록 KeyboardFocusManager에 통지하기 위해서 AWT에 의해 호출합니다.
protected abstract void	discardKeyEvents (Component comp) 지연 한 KeyEvents 디스패치를 취소하도록 KeyboardFocusManager에 통지하기 위해서 AWT에 의해 호출합니다.
abstract boolean	dispatchEvent (AWTEvent e) 이 메서드는 AWT 이벤트 디스팻쳐에 의해 불려가 현재의 KeyboardFocusManager가 그 메서드 대신에 지정된 이벤트를 디스패치 하도록 요구합니다.
abstract boolean	dispatchKeyEvent (KeyEvent e) 디스팻쳐 체인외의 KeyEventDispatcher가 KeyEvent를 디스패치 하지 않았던 경우, 또는 그 밖에 KeyEventDispatchers가 등록되지 않은 경우, 보통 이 메서드가 dispatchEvent에 의해 호출합니다.
void	downFocusCycle () 현재의 포커스의 소유자가 포커스 사이클의 루트인 Container인 경우에게만, 포커스를 현재의 포커스의 소유자로부터 1개 하의 포커스 traversal 사이클로 이동합니다.
abstract void	downFocusCycle (Container aContainer) 포커스를 1개 하의 포커스 traversal 사이클로 이동합니다.
protected abstract void	enqueueKeyEvents (long after, Component untilFocused) 지정된 Component가 포커스의 소유자가 될 때까지, KeyEvents 디스패치를 지연 시킬 필요가 있는 것을 KeyboardFocusManager에 통지하기 위해서 AWT에 의해 호출합니다.
protected void	firePropertyChange (String propertyName, Object oldValue, Object newValue) 바운드 프로퍼티의 변경에 응답해 PropertyChangeEvent를 트리거 합니다.
protected void	fireVetoableChange (String propertyName, Object oldValue, Object newValue) 거부 가능 프로퍼티의 변경에 응답해 PropertyChangeEvent를 트리거 합니다.
void	focusNextComponent () 현재의 포커스의 소유자의 뒤에 Component를 포커스 합니다.
abstract void	focusNextComponent (Component aComponent) 보통 FocusTraversalPolicy에 기반해 aComponent 나중에 Component를 포커스 합니다.
void	focusPreviousComponent () 현재의 포커스의 소유자의 앞에 Component를 포커스 합니다.
abstract void	focusPreviousComponent (Component aComponent) 보통 FocusTraversalPolicy에 기반해 aComponent 전에 Component를 포커스 합니다.
Window	getActiveWindow () 액티브 Window가 호출해 옆thread와 같은 컨텍스트에 있는 경우, 액티브 Window를 리턴합니다.
Container	getCurrentFocusCycleRoot () 현재의 포커스 사이클의 루트가 호출해 옆thread와 같은 컨텍스트에 있는 경우, 현재의 포커스 사이클의 루트를 리턴합니다.
static KeyboardFocusManager	getCurrentKeyboardFocusManager () thread의 컨텍스트 의 호출에 대해서 현재의 KeyboardFocusManager 인스턴스를 리턴합니다.
Set <AWTKeyStroke >	getDefaultFocusTraversalKeys (int id) 지정된 traversal 조작에 대해서 디폴트의 포커스 traversal 키의 Set를 리턴합니다.
FocusTraversalPolicy	getDefaultFocusTraversalPolicy () 디폴트의 FocusTraversalPolicy를 리턴합니다.
Window	getFocusedWindow () 포커스 된 Window 가 같은 호출해 옆thread와 같은 컨텍스트에 있는 경우, 포커스 된 Window를 리턴합니다.
Component	getFocusOwner () 포커스의 소유자가 호출해 옆과 같은 컨텍스트에 있는 경우, 포커스의 소유자를 리턴합니다.
protected Window	getGlobalActiveWindow () 호출측 thread가 액티브 Window와 다른 컨텍스트에 있는 경우에서도, 액티브 Window를 리턴합니다.
protected Container	getGlobalCurrentFocusCycleRoot () 호출측 thread가 현재의 포커스 사이클의 루트와 다른 컨텍스트에 있는 경우에서도, 현재의 포커스 사이클의 루트를 리턴합니다.
protected Window	getGlobalFocusedWindow () 호출측 thread가 포커스 된 Window와 다른 컨텍스트에 있는 경우에서도, 포커스 된 Window를 리턴합니다.
protected Component	getGlobalFocusOwner () 호출측 thread가 포커스의 소유자와 다른 컨텍스트에 있는 경우에서도, 포커스의 소유자를 리턴합니다.
protected Component	getGlobalPermanentFocusOwner () 영구 포커스의 소유자가 호출해 옆thread와 다른 컨텍스트에 있는 경우에서도, 영구 포커스의 소유자를 리턴합니다.
protected List <KeyEventDispatcher >	getKeyEventDispatchers () 이 KeyboardFocusManager KeyEventDispatcher 체인을 List 로서 리턴합니다.
protected List <KeyEventPostProcessor >	getKeyEventPostProcessors () 이 KeyboardFocusManager KeyEventPostProcessor 체인을 List 로서 리턴합니다.
Component	getPermanentFocusOwner () 영구 포커스의 소유자가 호출해 옆thread와 같은 컨텍스트에 있는 경우, 영구 포커스의 소유자를 리턴합니다.
PropertyChangeListener []	getPropertyChangeListeners () 이 키보드 포커스 매니저에 등록된 모든 프로퍼티 변경 리스너의 배열을 리턴합니다.
PropertyChangeListener []	getPropertyChangeListeners (String propertyName) 이름 첨부 프로퍼티에 관련된 모든 PropertyChangeListener 배열을 리턴합니다.
VetoableChangeListener []	getVetoableChangeListeners () 이 키보드 포커스 매니저에 등록된 모든 거부 가능한 변경 리스너의 배열을 리턴합니다.
VetoableChangeListener []	getVetoableChangeListeners (String propertyName) 이름 첨부 프로퍼티에 관련된 모든 VetoableChangeListener 배열을 리턴합니다.
abstract boolean	postProcessKeyEvent (KeyEvent e) 이 메서드는 dispatchKeyEvent에 의해 호출합니다.
abstract void	processKeyEvent (Component focusedComponent, KeyEvent e) KeyEvent가 지정된 focusedComponent에 대해서 포커스 traversal 키를 나타내는 경우에게만, 이 메서드는 포커스 traversal 조작을 초기화합니다.
void	redispatchEvent (Component target, AWTEvent e) AWT 이벤트 디스팻쳐에 대해서 KeyboardFocusManager, 또는 인스톨 된 임의의 KeyEventDispatchers가 재차 이벤트를 재귀적으로 디스패치 하는 것을 요구하지 않는 것 같은 방법으로 AWTEvent를 재디스패치 합니다.
void	removeKeyEventDispatcher (KeyEventDispatcher dispatcher) 이전에 이 KeyboardFocusManager 디스팻쳐 체인에 추가된 KeyEventDispatcher를 삭제합니다.
void	removeKeyEventPostProcessor (KeyEventPostProcessor processor) 이 KeyboardFocusManager 포스트프로세서의 체인으로부터, 이전에 추가된 KeyEventPostProcessor를 삭제합니다.
void	removePropertyChangeListener (PropertyChangeListener listener) 리스너 리스트로부터 PropertyChangeListener를 삭제합니다.
void	removePropertyChangeListener (String propertyName, PropertyChangeListener listener) 특정의 프로퍼티의 리스너 리스트로부터 PropertyChangeListener를 삭제합니다.
void	removeVetoableChangeListener (String propertyName, VetoableChangeListener listener) 특정의 프로퍼티의 리스너 리스트로부터 VetoableChangeListener를 삭제합니다.
void	removeVetoableChangeListener (VetoableChangeListener listener) 리스너 리스트로부터 VetoableChangeListener를 삭제합니다.
static void	setCurrentKeyboardFocusManager (KeyboardFocusManager newManager) thread의 컨텍스트 의 호출에 대해서 현재의 KeyboardFocusManager 인스턴스를 설정합니다.
void	setDefaultFocusTraversalKeys (int id, Set <? extends AWTKeyStroke > keystrokes) 지정된 traversal 조작에 대해서 디폴트의 포커스 traversal 키를 설정합니다.
void	setDefaultFocusTraversalPolicy (FocusTraversalPolicy defaultPolicy) 디폴트의 FocusTraversalPolicy를 설정합니다.
protected void	setGlobalActiveWindow (Window activeWindow) 액티브 Window를 설정합니다.
void	setGlobalCurrentFocusCycleRoot (Container newFocusCycleRoot) 현재의 포커스 사이클의 루트를 설정합니다.
protected void	setGlobalFocusedWindow (Window focusedWindow) 포커스 된 Window를 설정합니다.
protected void	setGlobalFocusOwner (Component focusOwner) 포커스의 소유자를 설정합니다.
protected void	setGlobalPermanentFocusOwner (Component permanentFocusOwner) 영구 포커스의 소유자를 설정합니다.
void	upFocusCycle () 포커스를 현재의 포커스의 소유자로부터 1개 상의 포커스 traversal 사이클로 이동합니다.
abstract void	upFocusCycle (Component aComponent) 포커스를 1개 상의 포커스 traversal 사이클로 이동합니다.

클래스 java.lang. Object 로부터 상속된 메서드

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

필드의 상세

FORWARD_TRAVERSAL_KEYS

public static final int FORWARD_TRAVERSAL_KEYS

Forward 포커스 traversal 키의 식별자입니다.

관련 항목:

setDefaultFocusTraversalKeys(int, java.util.Set), getDefaultFocusTraversalKeys(int), Component.setFocusTraversalKeys(int, java.util.Set), Component.getFocusTraversalKeys(int), 정수 필드값

BACKWARD_TRAVERSAL_KEYS

public static final int BACKWARD_TRAVERSAL_KEYS

Backward 포커스 traversal 키의 식별자입니다.

관련 항목:

setDefaultFocusTraversalKeys(int, java.util.Set), getDefaultFocusTraversalKeys(int), Component.setFocusTraversalKeys(int, java.util.Set), Component.getFocusTraversalKeys(int), 정수 필드값

UP_CYCLE_TRAVERSAL_KEYS

public static final int UP_CYCLE_TRAVERSAL_KEYS

Up Cycle 포커스 traversal 키의 식별자입니다.

관련 항목:

setDefaultFocusTraversalKeys(int, java.util.Set), getDefaultFocusTraversalKeys(int), Component.setFocusTraversalKeys(int, java.util.Set), Component.getFocusTraversalKeys(int), 정수 필드값

DOWN_CYCLE_TRAVERSAL_KEYS

public static final int DOWN_CYCLE_TRAVERSAL_KEYS

Down Cycle 포커스 traversal 키의 식별자입니다.

관련 항목:

setDefaultFocusTraversalKeys(int, java.util.Set), getDefaultFocusTraversalKeys(int), Component.setFocusTraversalKeys(int, java.util.Set), Component.getFocusTraversalKeys(int), 정수 필드값

생성자 상세

KeyboardFocusManager

public KeyboardFocusManager()

KeyboardFocusManager를 초기화합니다.

메서드의 상세

getCurrentKeyboardFocusManager

public static KeyboardFocusManager  getCurrentKeyboardFocusManager()

thread의 컨텍스트 의 호출에 대해서 현재의 KeyboardFocusManager 인스턴스를 리턴합니다.

반환값:

이 thread의 컨텍스트 의 KeyboardFocusManager

관련 항목:

setCurrentKeyboardFocusManager(java.awt.KeyboardFocusManager)

setCurrentKeyboardFocusManager

public static void setCurrentKeyboardFocusManager(KeyboardFocusManager  newManager)
                                           throws SecurityException 

thread의 컨텍스트 의 호출에 대해서 현재의 KeyboardFocusManager 인스턴스를 설정합니다. null이 지정되었을 경우, 현재의 KeyboardFocusManager는 DefaultKeyboardFocusManager 새로운 인스턴스로 옮겨집니다.

SecurityManager가 인스톨 되고 있는 경우, 호출측 thread는 현재의 KeyboardFocusManager를 옮겨놓기 위해서 AWTPermission "replaceKeyboardFocusManager"에 의해 접근 권한이 허가되고 있을 필요가 있습니다. 이 접근 권한이 허가되어 있지 않은 경우, 이 메서드는 SecurityException을 Throw 해, 현재의 KeyboardFocusManager는 변경되지 않습니다.

파라미터:

newManager - 이 thread의 컨텍스트에 대한 새로운 KeyboardFocusManager

예외:

SecurityException - 호출측 thread에 현재의 KeyboardFocusManager를 옮겨놓기 위해서 필요한 접근 권한이 없는 경우

관련 항목:

getCurrentKeyboardFocusManager(), DefaultKeyboardFocusManager

getFocusOwner

public Component  getFocusOwner()

포커스의 소유자가 호출해 옆과 같은 컨텍스트에 있는 경우, 포커스의 소유자를 리턴합니다. 포커스의 소유자는 보통 사용자에 의해 생성되는 모든 KeyEvents를 받는 어플리케이션의 Component 로서 정의됩니다. 포커스의 소유자에 대해서 포커스 traversal 키가 유효한 경우, 포커스의 소유자의 traversal 키에 매핑 되는 KeyEvents는 전송 되지 않습니다. 게다가 KeyEventDispatchers는 포커스의 소유자에게 도달하기 전에 KeyEvents를 타겟 변경하든가 또는 소비할 수 있습니다.

반환값:

포커스의 소유자, 또는 포커스의 소유자가 호출해 옆thread의 컨텍스트 의 멤버가 아닌 경우는 null

관련 항목:

getGlobalFocusOwner(), setGlobalFocusOwner(java.awt.Component)

getGlobalFocusOwner

protected Component  getGlobalFocusOwner()
                                 throws SecurityException 

호출측 thread가 포커스의 소유자와 다른 컨텍스트에 있는 경우에서도, 포커스의 소유자를 리턴합니다. 포커스의 소유자는 보통 사용자에 의해 생성되는 모든 KeyEvents를 받는 어플리케이션의 Component 로서 정의됩니다. 포커스의 소유자에 대해서 포커스 traversal 키가 유효한 경우, 포커스의 소유자의 traversal 키에 매핑 되는 KeyEvents는 전송 되지 않습니다. 게다가 KeyEventDispatchers는 포커스의 소유자에게 도달하기 전에 KeyEvents를 타겟 변경하든가 또는 소비할 수 있습니다.

이 KeyboardFocusManager가 호출해 옆thread의 컨텍스트에 대한 현재의 KeyboardFocusManager가 아닌 경우, 이 메서드는 SecurityException을 Throw 합니다.

반환값:

포커스의 소유자

예외:

SecurityException - 이 KeyboardFocusManager가 호출해 옆thread의 컨텍스트에 대한 현재의 KeyboardFocusManager가 아닌 경우

관련 항목:

getFocusOwner(), setGlobalFocusOwner(java.awt.Component)

setGlobalFocusOwner

protected void setGlobalFocusOwner(Component  focusOwner)

포커스의 소유자를 설정합니다. Component가 포커스 불가능한 경우, 조작은 삭제됩니다. 포커스의 소유자는 보통 사용자에 의해 생성되는 모든 KeyEvents를 받는 어플리케이션의 Component 로서 정의됩니다. 포커스의 소유자에 대해서 포커스 traversal 키가 유효한 경우, 포커스의 소유자의 traversal 키에 매핑 되는 KeyEvents는 전송 되지 않습니다. 게다가 KeyEventDispatchers는 포커스의 소유자에게 도달하기 전에 KeyEvents를 타겟 변경하든가 또는 소비할 수 있습니다.

이 메서드는 실제로 지정된 Component에 대한 포커스를 설정하지 않습니다. 이것은 후에 getFocusOwner()에 의해 리턴된 값을 단지 포함할 뿐입니다. Component.requestFocus() 또는 Component.requestFocusInWindow()를 사용해, 플랫폼의 제한에 따라 포커스의 소유자를 변경합니다.

파라미터:

focusOwner - 포커스의 소유자

관련 항목:

getFocusOwner(), getGlobalFocusOwner(), Component.requestFocus(), Component.requestFocusInWindow(), Component.isFocusable()

clearGlobalFocusOwner

public void clearGlobalFocusOwner()

Java 및 네이티브 레벨의 양쪽 모두로 글로벌 포커스의 소유자를 클리어 합니다. 포커스의 소유자가 존재하는 경우, 그러한 Component는 영구 FOCUS_LOST 이벤트를 받습니다. 이 조작이 완료하면, 네이티브의 윈도우 처리 시스템은 사용자가 새로운 Component를 선택해 포커스를 받는지, 또는 Component가 requestFocus()에 의 호출에 의해 명시적으로 포커스가 부여될 때까지, 사용자가 생성한 모든 KeyEvents를 파기합니다. 이 조작은 포커스 된 Window 또는 활성화된 Window를 변경하지 않습니다.

관련 항목:

Component.requestFocus(), FocusEvent.FOCUS_LOST

getPermanentFocusOwner

public Component  getPermanentFocusOwner()

영구 포커스의 소유자가 호출해 옆thread와 같은 컨텍스트에 있는 경우, 영구 포커스의 소유자를 리턴합니다. 영구 포커스의 소유자는 영구 FOCUS_GAINED 이벤트를 받는 어플리케이션의 마지막 Component 로서 정의됩니다. 포커스의 소유자와 영구 포커스의 소유자는 텐포라리포카스의 변경이 현재 유효하지 않은 경우에 한정해 동등합니다. 이러한 경우, 영구 포커스의 소유자는 텐포라리포카스의 변경이 종료하면 다시 포커스의 소유자가 됩니다.

반환값:

영구 포커스의 소유자, 또는 영구 포커스의 소유자가 호출해 옆thread의 컨텍스트 의 멤버가 아닌 경우는 null

관련 항목:

getGlobalPermanentFocusOwner(), setGlobalPermanentFocusOwner(java.awt.Component)

getGlobalPermanentFocusOwner

protected Component  getGlobalPermanentFocusOwner()
                                          throws SecurityException 

영구 포커스의 소유자가 호출해 옆thread와 다른 컨텍스트에 있는 경우에서도, 영구 포커스의 소유자를 리턴합니다. 영구 포커스의 소유자는 영구 FOCUS_GAINED 이벤트를 받는 어플리케이션의 마지막 Component 로서 정의됩니다. 포커스의 소유자와 영구 포커스의 소유자는 텐포라리포카스의 변경이 현재 유효하지 않은 경우에 한정해 동등합니다. 이러한 경우, 영구 포커스의 소유자는 텐포라리포카스의 변경이 종료하면 다시 포커스의 소유자가 됩니다.

이 KeyboardFocusManager가 호출해 옆thread의 컨텍스트에 대한 현재의 KeyboardFocusManager가 아닌 경우, 이 메서드는 SecurityException을 Throw 합니다.

반환값:

영구 포커스의 소유자

예외:

SecurityException - 이 KeyboardFocusManager가 호출해 옆thread의 컨텍스트에 대한 현재의 KeyboardFocusManager 이 아닌 경우

관련 항목:

getPermanentFocusOwner(), setGlobalPermanentFocusOwner(java.awt.Component)

setGlobalPermanentFocusOwner

protected void setGlobalPermanentFocusOwner(Component  permanentFocusOwner)

영구 포커스의 소유자를 설정합니다. 이 조작은 Component가 포커스 불가능한 경우, 삭제됩니다. 영구 포커스의 소유자는 영구 FOCUS_GAINED 이벤트를 받는 어플리케이션의 마지막 Component 로서 정의됩니다. 포커스의 소유자와 영구 포커스의 소유자는 텐포라리포카스의 변경이 현재 유효하지 않은 경우에 한정해 동등합니다. 이러한 경우, 영구 포커스의 소유자는 텐포라리포카스의 변경이 종료하면 다시 포커스의 소유자가 됩니다.

이 메서드는 실제로 지정된 Component에 대한 포커스를 설정하지 않습니다. 이것은 후에 getPermanentFocusOwner()에 의해 리턴된 값을 단지 포함할 뿐입니다. Component.requestFocus() 또는 Component.requestFocusInWindow()를 사용해, 플랫폼의 제한에 따라 포커스의 소유자를 변경합니다.

파라미터:

permanentFocusOwner - 영구 포커스의 소유자

관련 항목:

getPermanentFocusOwner(), getGlobalPermanentFocusOwner(), Component.requestFocus(), Component.requestFocusInWindow(), Component.isFocusable()

getFocusedWindow

public Window  getFocusedWindow()

포커스 된 Window 가 같은 호출해 옆thread와 같은 컨텍스트에 있는 경우, 포커스 된 Window를 리턴합니다. 포커스 된 Window는 포커스의 소유자이든가 또는 포커스의 소유자를 포함한 Window 입니다.

반환값:

포커스 된 Window, 또는 포커스 된 Window가 호출해 옆thread의 컨텍스트 의 멤버가 아닌 경우는 null

관련 항목:

getGlobalFocusedWindow(), setGlobalFocusedWindow(java.awt.Window)

getGlobalFocusedWindow

protected Window  getGlobalFocusedWindow()
                                 throws SecurityException 

호출측 thread가 포커스 된 Window와 다른 컨텍스트에 있는 경우에서도, 포커스 된 Window를 리턴합니다. 포커스 된 Window는 포커스의 소유자이든가 또는 포커스의 소유자를 포함한 Window 입니다.

이 KeyboardFocusManager가 호출해 옆thread의 컨텍스트에 대한 현재의 KeyboardFocusManager가 아닌 경우, 이 메서드는 SecurityException을 Throw 합니다.

반환값:

포커스 된 Window

예외:

SecurityException - 이 KeyboardFocusManager가 호출해 옆thread의 컨텍스트에 대한 현재의 KeyboardFocusManager가 아닌 경우

관련 항목:

getFocusedWindow(), setGlobalFocusedWindow(java.awt.Window)

setGlobalFocusedWindow

protected void setGlobalFocusedWindow(Window  focusedWindow)

포커스 된 Window를 설정합니다. 포커스 된 Window는 포커스의 소유자이든가 또는 포커스의 소유자를 포함한 Window 입니다. 포커스가 지정된 Window가 포커스 불가능한 Window인 경우, 이 조작은 삭제됩니다.

이 메서드는 네이티브의 윈도우 처리 시스템에 관한한, 실제로 포커스 된 Window 변경을 실시하지 않습니다. 이것은 후에 getFocusedWindow()에 의해 리턴된 값을 단지 포함할 뿐입니다. Component.requestFocus() 또는 Component.requestFocusInWindow()를 사용해, 플랫폼의 제한에 따라 포커스 된 Window를 변경합니다.

파라미터:

focusedWindow - 포커스 된 Window

관련 항목:

getFocusedWindow(), getGlobalFocusedWindow(), Component.requestFocus(), Component.requestFocusInWindow(), Window.isFocusableWindow()

getActiveWindow

public Window  getActiveWindow()

액티브 Window가 호출해 옆thread와 같은 컨텍스트에 있는 경우, 액티브 Window를 리턴합니다. Frame 또는 Dialog 만이 액티브 Window가 됩니다. 네이티브의 윈도우 처리 시스템은 액티브 Window 또는 하이라이트 된 타이틀 바 등 특별한 장식을 가지는 그 자식을 나타냅니다. 액티브 Window는 항상, 포커스 된 Window 인가 또는 포커스 된 Window 소유자인 최초의 Frame 또는 Dialog 머지않아인가입니다.

반환값:

액티브 Window, 또는 액티브 Window가 호출해 옆thread의 컨텍스트 의 멤버가 아닌 경우는 null

관련 항목:

getGlobalActiveWindow(), setGlobalActiveWindow(java.awt.Window)

getGlobalActiveWindow

protected Window  getGlobalActiveWindow()
                                throws SecurityException 

호출측 thread가 액티브 Window와 다른 컨텍스트에 있는 경우에서도, 액티브 Window를 리턴합니다. Frame 또는 Dialog 만이 액티브 Window가 됩니다. 네이티브의 윈도우 처리 시스템은 액티브 Window 또는 하이라이트 된 타이틀 바 등 특별한 장식을 가지는 그 자식을 나타냅니다. 액티브 Window는 항상, 포커스 된 Window 인가 또는 포커스 된 Window 소유자인 최초의 Frame 또는 Dialog 머지않아인가입니다.

이 KeyboardFocusManager가 호출해 옆thread의 컨텍스트에 대한 현재의 KeyboardFocusManager가 아닌 경우, 이 메서드는 SecurityException을 Throw 합니다.

반환값:

액티브 Window

예외:

SecurityException - 이 KeyboardFocusManager가 호출해 옆thread의 컨텍스트에 대한 현재의 KeyboardFocusManager가 아닌 경우

관련 항목:

getActiveWindow(), setGlobalActiveWindow(java.awt.Window)

setGlobalActiveWindow

protected void setGlobalActiveWindow(Window  activeWindow)

액티브 Window를 설정합니다. Frame 또는 Dialog 만이 액티브 Window가 됩니다. 네이티브의 윈도우 처리 시스템은 액티브 Window 또는 하이라이트 된 타이틀 바 등 특별한 장식을 가지는 그 자식을 나타냅니다. 액티브 Window는 항상, 포커스 된 Window 인가 또는 포커스 된 Window 소유자인 최초의 Frame 또는 Dialog 머지않아인가입니다.

이 메서드는 네이티브의 윈도우 처리 시스템에 관한한, 실제로 액티브 Window 변경을 실시하지 않습니다. 이것은 후에 getActiveWindow()에 의해 리턴된 값을 단지 포함할 뿐입니다. Component.requestFocus() 또는 Component.requestFocusInWindow()를 사용해, 플랫폼의 제한에 따라 포커스 된 Window를 변경합니다.

파라미터:

activeWindow - 액티브 Window

관련 항목:

getActiveWindow(), getGlobalActiveWindow(), Component.requestFocus(), Component.requestFocusInWindow()

getDefaultFocusTraversalPolicy

public FocusTraversalPolicy  getDefaultFocusTraversalPolicy()

디폴트의 FocusTraversalPolicy를 리턴합니다. 톱 레벨의 컴퍼넌트는 작성시에 이 값을 사용해 Container.setFocusTraversalPolicy를 명시적으로 호출해, 자기 자신의 포커스 traversal 정책를 초기화합니다.

반환값:

디폴트의 FocusTraversalPolicy. null을 돌려줄 것은 없는

관련 항목:

setDefaultFocusTraversalPolicy(java.awt.FocusTraversalPolicy), Container.setFocusTraversalPolicy(java.awt.FocusTraversalPolicy), Container.getFocusTraversalPolicy()

setDefaultFocusTraversalPolicy

public void setDefaultFocusTraversalPolicy(FocusTraversalPolicy  defaultPolicy)

디폴트의 FocusTraversalPolicy를 설정합니다. 톱 레벨의 컴퍼넌트는 작성시에 이 값을 사용해 Container.setFocusTraversalPolicy를 명시적으로 호출해, 자기 자신의 포커스 traversal 정책를 초기화합니다. 주: 이 호출은 정책가 초기화되고 있기 때문에 이미 작성 끝난 컴퍼넌트에 영향을 주지 않습니다. 새로운 컴퍼넌트만이 디폴트 정책 로서 이 정책를 사용합니다.

파라미터:

defaultPolicy - 새로운 디폴트의 FocusTraversalPolicy

예외:

IllegalArgumentException - defaultPolicy가 null인 경우

관련 항목:

getDefaultFocusTraversalPolicy(), Container.setFocusTraversalPolicy(java.awt.FocusTraversalPolicy), Container.getFocusTraversalPolicy()

setDefaultFocusTraversalKeys

public void setDefaultFocusTraversalKeys(int id,
                                         Set <?  extends AWTKeyStroke > keystrokes)

지정된 traversal 조작에 대해서 디폴트의 포커스 traversal 키를 설정합니다. 이 traversal 키 Set는 이러한 명시적으로 정의된 자기 자신의 Set를 가지지 않는 모든 Window로 유효합니다. 또, 이 Set는 명시적으로 정의된 자기 자신의 Set를 가지지 않는 이러한 Windows 임의의자식 Component에 의해 재귀적으로 상속됩니다.

디폴트의 포커스 traversal 키의 기정치는 구현에 의존합니다. Sun는 특정의 네이티브인 플랫폼에 대한 모든 구현으로 같은 설정값을 사용하는 것을 추천합니다. Windows 및 Unix에 대한 추천은 다음에 리스트 되고 있습니다. 이러한 추천은 Sun AWT 구현으로 사용됩니다.

식별자	의미	디폴트
KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS	보통 의 순서 방향 키보드 traversal	KEY_PRESSED 상의 TAB, KEY_PRESSED 상의 CTRL-TAB
KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS	보통 의 리버스 키보드 traversal	KEY_PRESSED 상의 SHIFT-TAB, KEY_PRESSED 상의 CTRL-SHIFT-TAB
KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS	1개 상의 포커스 traversal 사이클에 이동	없음
KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS	1개 하의 포커스 traversal 사이클에 이동	없음

traversal 키를 무효로 하려면, 비어있는 Set를 사용합니다. Collections.EMPTY_SET 사용을 추천합니다.

AWTKeyStroke API를 사용해, 특정의 KeyEvent KEY_PRESSED 또는 KEY_RELEASED 양쪽 모두로 클라이언트 코드를 지정할 수 있도록 하면, 포커스 traversal의 조작이 발생합니다. 다만, 어느 쪽의 KeyEvent이 지정되어도, 관련된 KEY_TYPED 이벤트를 포함한, 포커스 traversal 키에 관련된 모든 KeyEvent이 소비되어, 어느 Component에 도 디스패치 되지 않습니다. 이것은 KEY_TYPED 이벤트를 포커스 traversal 조작에 매핑 하도록 지정하는지, 또는 같은 이벤트를 복수의 디폴트의 포커스 traversal 조작에 매핑 하는 실행시 에러입니다.

파라미터:

id - 다음의 어느쪽이든 1개. KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, 또는 KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS

keystrokes - 지정된 조작에 대한 AWTKeyStroke Set

예외:

IllegalArgumentException - id가 KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, 또는 KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS 어떤 것도 아닌 경우, 키스트로크(keystroke)가 null인 경우, 키스트로크(keystroke)에 null이 포함되는 경우, 키스트로크(keystroke)의 임의의 Object이 AWTKeyStroke가 아닌 경우, 또는 임의의 키스트로크(keystroke)가 KEY_TYPED 이벤트를 나타내는 경우, 또는 임의의 키스트로크(keystroke)가 이미 다른 디폴트의 포커스 traversal 조작에 매핑 되고 있는 경우

관련 항목:

getDefaultFocusTraversalKeys(int), Component.setFocusTraversalKeys(int, java.util.Set), Component.getFocusTraversalKeys(int)

getDefaultFocusTraversalKeys

public Set <AWTKeyStroke > getDefaultFocusTraversalKeys(int id)

지정된 traversal 조작에 대해서 디폴트의 포커스 traversal 키의 Set를 리턴합니다. 이 traversal 키의 Set는 명시적으로 정의된 자기 자신의 Window 가운데, 이러한 Set를 가지지 않는 모든 Window 로 유효합니다. 또, 이 Set는 명시적으로 정의된 Set를 가지지 않는 이러한 Window 자식 Component에 의해 재귀적으로 상속됩니다 ( 각 조작의 상세 설명은, setDefaultFocusTraversalKeys를 참조하십시오).

파라미터:

id - 다음의 어느쪽이든 1개. KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, 또는 KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS

반환값:

지정된 조작에 대한 AWTKeyStroke Set. Set는 변경하지 못하고, 비어있는 경우가 있다. null이 돌려주고질 것은 없다

예외:

IllegalArgumentException - id가 다음의 어떤 것도 아닌 경우. KeyboardFocusManager.FORWARD_TRAVERSAL_KEYS, KeyboardFocusManager.BACKWARD_TRAVERSAL_KEYS, KeyboardFocusManager.UP_CYCLE_TRAVERSAL_KEYS, 또는 KeyboardFocusManager.DOWN_CYCLE_TRAVERSAL_KEYS

관련 항목:

setDefaultFocusTraversalKeys(int, java.util.Set), Component.setFocusTraversalKeys(int, java.util.Set), Component.getFocusTraversalKeys(int)

getCurrentFocusCycleRoot

public Container  getCurrentFocusCycleRoot()

현재의 포커스 사이클의 루트가 호출해 옆thread와 같은 컨텍스트에 있는 경우, 현재의 포커스 사이클의 루트를 리턴합니다. 포커스의 소유자 자체가 포커스 사이클의 루트의 경우, 보통 의 포커스 traversal의 사이에 어느 Component가 다음 또는 직전의 Component를 나타낼까에 임해서, 애매하게 되는 경우가 있습니다. 이 경우는 현재의 포커스 사이클의 루트를 사용해, 가능성이 있는 Component 로부터 식별합니다.

이 메서드는 KeyboardFocusManagers 및 포커스의 구현 전용입니다. 일반적인 클라이언트가 사용하는 것이 아닙니다.

반환값:

현재의 포커스 사이클의 루트, 또는 현재의 포커스 사이클의 루트가 호출해 옆thread의 컨텍스트 의 멤버가 아닌 경우는 null

관련 항목:

getGlobalCurrentFocusCycleRoot(), setGlobalCurrentFocusCycleRoot(java.awt.Container)

getGlobalCurrentFocusCycleRoot

protected Container  getGlobalCurrentFocusCycleRoot()
                                            throws SecurityException 

호출측 thread가 현재의 포커스 사이클의 루트와 다른 컨텍스트에 있는 경우에서도, 현재의 포커스 사이클의 루트를 리턴합니다. 포커스의 소유자 자체가 포커스 사이클의 루트의 경우, 보통 의 포커스 traversal의 사이에 어느 Component가 다음 또는 직전의 Component를 나타낼까에 임해서, 애매하게 되는 경우가 있습니다. 이 경우는 현재의 포커스 사이클의 루트를 사용해, 가능성이 있는 Component 로부터 식별합니다.

이 KeyboardFocusManager가 호출해 옆thread의 컨텍스트에 대한 현재의 KeyboardFocusManager가 아닌 경우, 이 메서드는 SecurityException을 Throw 합니다.

반환값:

현재의 포커스 사이클의 루트, 또는 현재의 포커스 사이클의 루트가 호출해 옆thread의 컨텍스트 의 멤버가 아닌 경우는 null

예외:

SecurityException - 이 KeyboardFocusManager가 호출해 옆thread의 컨텍스트에 대한 현재의 KeyboardFocusManager가 아닌 경우

관련 항목:

getCurrentFocusCycleRoot(), setGlobalCurrentFocusCycleRoot(java.awt.Container)

setGlobalCurrentFocusCycleRoot

public void setGlobalCurrentFocusCycleRoot(Container  newFocusCycleRoot)

현재의 포커스 사이클의 루트를 설정합니다. 포커스의 소유자 자체가 포커스 사이클의 루트의 경우, 보통 의 포커스 traversal의 사이에 어느 Component가 다음 또는 직전의 Component를 나타낼까에 임해서, 애매하게 되는 경우가 있습니다. 이 경우는 현재의 포커스 사이클의 루트를 사용해, 가능성이 있는 Component 로부터 식별합니다.

이 메서드는 KeyboardFocusManagers 및 포커스의 구현 전용입니다. 일반적인 클라이언트가 사용하는 것이 아닙니다.

파라미터:

newFocusCycleRoot - 새로운 포커스 사이클의 루트

관련 항목:

getCurrentFocusCycleRoot(), getGlobalCurrentFocusCycleRoot()

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener  listener)

PropertyChangeListener를 리스너 리스트에 추가합니다. 이 리스너는 다음과 같은 클래스를 포함한 이 클래스의 모든 바운드 프로퍼티에 등록됩니다.

• KeyboardFocusManager가 현재 이 어플리케이션 또는 애플릿의 브라우저 컨텍스트 의 포커스를 관리하고 있을지 어떨지 ("managingFocus")
• 포커스의 소유자 ("focusOwner")
• 영구 포커스의 소유자 ("permanentFocusOwner")
• 포커스 된 Window ("focusedWindow")
• 액티브 Window ("activeWindow")
• 디폴트의 포커스 traversal 정책 ("defaultFocusTraversalPolicy")
• 디폴트의 FORWARD_TRAVERSAL_KEYS Set ("forwardDefaultFocusTraversalKeys")
• 디폴트의 BACKWARD_TRAVERSAL_KEYS Set ("backDefaultFocusTraversalKeys")
• 디폴트의 UP_CYCLE_TRAVERSAL_KEYS Set ("upCycleDefaultFocusTraversalKeys")
• 디폴트의 DOWN_CYCLE_TRAVERSAL_KEYS Set ("downCycleDefaultFocusTraversalKeys")
• 현재의 포커스 사이클의 루트 ("currentFocusCycleRoot")

listener가 null인 경우는 예외가 발생되지 않고 아무것도 처리는 없습니다.

파라미터:

listener - 추가하는 PropertyChangeListener

관련 항목:

removePropertyChangeListener(java.beans.PropertyChangeListener), getPropertyChangeListeners(), addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener)

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener  listener)

리스너 리스트로부터 PropertyChangeListener를 삭제합니다. 이 메서드는 이 클래스의 모든 바운드 프로퍼티에 등록된 PropertyChangeListeners를 삭제하기 위해서 사용할 필요가 있습니다.

listener가 null인 경우는 예외가 발생되지 않고 아무것도 처리는 없습니다.

파라미터:

listener - 삭제하는 PropertyChangeListener

관련 항목:

addPropertyChangeListener(java.beans.PropertyChangeListener), getPropertyChangeListeners(), removePropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener)

getPropertyChangeListeners

public PropertyChangeListener [] getPropertyChangeListeners()

이 키보드 포커스 매니저에 등록된 모든 프로퍼티 변경 리스너의 배열을 리턴합니다.

반환값:

모든 이 키보드 포커스 매니저의 PropertyChangeListener, 또는 현재 프로퍼티 변경 리스너가 등록되지 않은 경우는 비어있는 배열

도입된 버전 :

1.4

관련 항목:

addPropertyChangeListener(java.beans.PropertyChangeListener), removePropertyChangeListener(java.beans.PropertyChangeListener), getPropertyChangeListeners(java.lang.String)

addPropertyChangeListener

public void addPropertyChangeListener(String  propertyName,
                                      PropertyChangeListener  listener)

특정의 프로퍼티의 리스너 리스트에 PropertyChangeListener를 추가합니다. 지정된 프로퍼티는 사용자 정의의 경우인가 또는 다음의 머지않아인가입니다.

• KeyboardFocusManager가 현재 이 어플리케이션 또는 애플릿의 브라우저 컨텍스트 의 포커스를 관리하고 있을지 어떨지 ("managingFocus")
• 포커스의 소유자 ("focusOwner")
• 영구 포커스의 소유자 ("permanentFocusOwner")
• 포커스 된 Window ("focusedWindow")
• 액티브 Window ("activeWindow")
• 디폴트의 포커스 traversal 정책 ("defaultFocusTraversalPolicy")
• 디폴트의 FORWARD_TRAVERSAL_KEYS Set ("forwardDefaultFocusTraversalKeys")
• 디폴트의 BACKWARD_TRAVERSAL_KEYS Set ("backDefaultFocusTraversalKeys")
• 디폴트의 UP_CYCLE_TRAVERSAL_KEYS Set ("upCycleDefaultFocusTraversalKeys")
• 디폴트의 DOWN_CYCLE_TRAVERSAL_KEYS Set ("downCycleDefaultFocusTraversalKeys")
• 현재의 포커스 사이클의 루트 ("currentFocusCycleRoot")

listener가 null인 경우는 예외가 발생되지 않고 아무것도 처리는 없습니다.

파라미터:

propertyName - 상기의 프로퍼티명의 어느쪽이든

listener - 추가하는 PropertyChangeListener

관련 항목:

addPropertyChangeListener(java.beans.PropertyChangeListener), removePropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener), getPropertyChangeListeners(java.lang.String)

removePropertyChangeListener

public void removePropertyChangeListener(String  propertyName,
                                         PropertyChangeListener  listener)

특정의 프로퍼티의 리스너 리스트로부터 PropertyChangeListener를 삭제합니다. 이 메서드는 특정의 바운드 프로퍼티에 등록된 PropertyChangeListeners를 삭제하기 위해서 사용할 필요가 있습니다.

listener가 null인 경우는 예외가 발생되지 않고 아무것도 처리는 없습니다.

파라미터:

propertyName - 유효한 프로퍼티명

listener - 삭제하는 PropertyChangeListener

관련 항목:

addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener), getPropertyChangeListeners(java.lang.String), removePropertyChangeListener(java.beans.PropertyChangeListener)

getPropertyChangeListeners

public PropertyChangeListener [] getPropertyChangeListeners(String  propertyName)

이름 첨부 프로퍼티에 관련된 모든 PropertyChangeListener 배열을 리턴합니다.

반환값:

이름 첨부 프로퍼티에 관련된 모든 PropertyChangeListener 또는 이러한 리스너가 추가되어 있지 않은 경우는 비어있는 배열

도입된 버전 :

1.4

관련 항목:

addPropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener), removePropertyChangeListener(java.lang.String, java.beans.PropertyChangeListener)

firePropertyChange

protected void firePropertyChange(String  propertyName,
                                  Object  oldValue,
                                  Object  newValue)

바운드 프로퍼티의 변경에 응답해 PropertyChangeEvent를 트리거 합니다. 이 이벤트는 등록된 모든 PropertyChangeListeners에 송신됩니다. oldValue와 newValue가 같은 경우, 이벤트는 송신되지 않습니다.

파라미터:

propertyName - 변경된 프로퍼티의 이름

oldValue - 프로퍼티의 이전의 값

newValue - 프로퍼티의 새로운 값

addVetoableChangeListener

public void addVetoableChangeListener(VetoableChangeListener  listener)

VetoableChangeListener를 리스너 리스트에 추가합니다. 이 리스너는 다음과 같은 클래스를 포함한 이 클래스의 모든 거부 가능 프로퍼티에 등록됩니다.

• 포커스의 소유자 ("focusOwner")
• 영구 포커스의 소유자 ("permanentFocusOwner")
• 포커스 된 Window ("focusedWindow")
• 액티브 Window ("activeWindow")

listener가 null인 경우는 예외가 발생되지 않고 아무것도 처리는 없습니다.

파라미터:

listener - 추가하는 VetoableChangeListener

관련 항목:

removeVetoableChangeListener(java.beans.VetoableChangeListener), getVetoableChangeListeners(), addVetoableChangeListener(java.lang.String, java.beans.VetoableChangeListener)

removeVetoableChangeListener

public void removeVetoableChangeListener(VetoableChangeListener  listener)

리스너 리스트로부터 VetoableChangeListener를 삭제합니다. 이 메서드는 이 클래스의 모든 거부 가능 프로퍼티에 등록된 VetoableChangeListeners를 삭제하기 위해서 사용할 필요가 있습니다.

listener가 null인 경우는 예외가 발생되지 않고 아무것도 처리는 없습니다.

파라미터:

listener - 삭제하는 VetoableChangeListener

관련 항목:

addVetoableChangeListener(java.beans.VetoableChangeListener), getVetoableChangeListeners(), removeVetoableChangeListener(java.lang.String, java.beans.VetoableChangeListener)

getVetoableChangeListeners

public VetoableChangeListener [] getVetoableChangeListeners()

이 키보드 포커스 매니저에 등록된 모든 거부 가능한 변경 리스너의 배열을 리턴합니다.

반환값:

모든 이 키보드 포커스 매니저의 VetoableChangeListener, 또는 현재 거부 가능한 변경 리스너가 등록되지 않은 경우는 비어있는 배열

도입된 버전 :

1.4

관련 항목:

addVetoableChangeListener(java.beans.VetoableChangeListener), removeVetoableChangeListener(java.beans.VetoableChangeListener), getVetoableChangeListeners(java.lang.String)

addVetoableChangeListener

public void addVetoableChangeListener(String  propertyName,
                                      VetoableChangeListener  listener)

특정의 프로퍼티의 리스너 리스트에 VetoableChangeListener를 추가합니다. 지정된 프로퍼티는 사용자 정의의 경우인가 또는 다음의 머지않아인가입니다.

• 포커스의 소유자 ("focusOwner")
• 영구 포커스의 소유자 ("permanentFocusOwner")
• 포커스 된 Window ("focusedWindow")
• 액티브 Window ("activeWindow")

listener가 null인 경우는 예외가 발생되지 않고 아무것도 처리는 없습니다.

파라미터:

propertyName - 상기의 프로퍼티명의 어느쪽이든

listener - 추가하는 VetoableChangeListener

관련 항목:

addVetoableChangeListener(java.beans.VetoableChangeListener), removeVetoableChangeListener(java.beans.VetoableChangeListener), getVetoableChangeListeners()

removeVetoableChangeListener

public void removeVetoableChangeListener(String  propertyName,
                                         VetoableChangeListener  listener)

특정의 프로퍼티의 리스너 리스트로부터 VetoableChangeListener를 삭제합니다. 이 메서드는 특정의 바운드 프로퍼티에 등록된 VetoableChangeListeners를 삭제하기 위해서 사용할 필요가 있습니다.

listener가 null인 경우는 예외가 발생되지 않고 아무것도 처리는 없습니다.

파라미터:

propertyName - 유효한 프로퍼티명

listener - 삭제하는 VetoableChangeListener

관련 항목:

addVetoableChangeListener(java.beans.VetoableChangeListener), getVetoableChangeListeners(), removeVetoableChangeListener(java.beans.VetoableChangeListener)

getVetoableChangeListeners

public VetoableChangeListener [] getVetoableChangeListeners(String  propertyName)

이름 첨부 프로퍼티에 관련된 모든 VetoableChangeListener 배열을 리턴합니다.

반환값:

이름 첨부 프로퍼티에 관련된 모든 VetoableChangeListener 또는 이러한 리스너가 추가되어 있지 않은 경우는 비어있는 배열

도입된 버전 :

1.4

관련 항목:

addVetoableChangeListener(java.lang.String, java.beans.VetoableChangeListener), removeVetoableChangeListener(java.lang.String, java.beans.VetoableChangeListener), getVetoableChangeListeners()

fireVetoableChange

protected void fireVetoableChange(String  propertyName,
                                  Object  oldValue,
                                  Object  newValue)
                           throws PropertyVetoException 

거부 가능 프로퍼티의 변경에 응답해 PropertyChangeEvent를 트리거 합니다. 이 이벤트는 등록된 모든 VetoableChangeListeners에 송신됩니다. VetoableChangeListener가 PropertyVetoException을 Throw 하는 경우, 새로운 이벤트가 트리거 되어 모든 VetoableChangeListeners가 낡은 값에 되돌려져 예외가 재발생 됩니다. oldValue와 newValue가 같은 경우는 이벤트는 송신되지 않습니다.

파라미터:

propertyName - 변경된 프로퍼티의 이름

oldValue - 프로퍼티의 이전의 값

newValue - 프로퍼티의 새로운 값

예외:

PropertyVetoException - VetoableChangeListener가 PropertyVetoException을 Throw 하는 경우

addKeyEventDispatcher

public void addKeyEventDispatcher(KeyEventDispatcher  dispatcher)

KeyEventDispatcher을 이 KeyboardFocusManager 디스팻쳐 체인에 추가합니다. 이 KeyboardFocusManager는 각 KeyEventDispatcher가 최종적으로 KeyEvent 자체를 디스패치 하기 전에 사용자에 의해 생성된 KeyEvents를 디스패치 하도록 요구합니다. KeyEventDispatchers는 추가된 순서로 통지됩니다. 통지는 1개의 KeyEventDispatcher가 그 dispatchKeyEvent 메서드로부터 true를 돌려주자마자 정지합니다. 추가되는 KeyEventDispatchers 총수에 제한은 없습니다. 또, 특정의 KeyEventDispatcher 인스턴스에 추가되는 회수에도 제한은 없습니다.

디스팻쳐가 null 로 지정되면, 처리는 행해지지 않고, 예외는 Throw 되지 않습니다.

파라미터:

dispatcher - 디스팻쳐 체인에 추가하는 KeyEventDispatcher

관련 항목:

removeKeyEventDispatcher(java.awt.KeyEventDispatcher)

removeKeyEventDispatcher

public void removeKeyEventDispatcher(KeyEventDispatcher  dispatcher)

이전에 이 KeyboardFocusManager 디스팻쳐 체인에 추가된 KeyEventDispatcher를 삭제합니다. 이 KeyboardFocusManager 자체는 addKeyEventDispatcher에 의 호출을 통해서 명시적으로 재등록되었을 경우 이외는 삭제될 것은 없습니다.

디스팻쳐가 null 로 지정되었을 경우, 지정된 디스팻쳐가 디스팻쳐 체인에 없는 경우, 또는 이 KeyboardFocusManager가 명시적으로 재등록되지 않고 로 지정되었을 경우, 처리는 행해지지 않고, 예외는 Throw 되지 않습니다.

파라미터:

dispatcher - 디스팻쳐 체인으로부터 삭제하는 KeyEventDispatcher

관련 항목:

addKeyEventDispatcher(java.awt.KeyEventDispatcher)

getKeyEventDispatchers

protected List <KeyEventDispatcher > getKeyEventDispatchers()

이 KeyboardFocusManager KeyEventDispatcher 체인을 List 로서 리턴합니다. 이 List 에는 addKeyEventDispatcher에 의 호출을 통해서 명시적으로 재등록되었을 경우 이외는 이 KeyboardFocusManager는 포함되지 않습니다. 그 외의 KeyEventDispatchers가 등록되지 않는 경우, 구현은 null 또는 길이 0 List를 자유롭게 리턴합니다. 클라이언트 코드는 다른 동작을 있는 동작과 상정하거나 일단 확립된 동작은 변경되지 않으면 상정하거나 해서는 안됩니다.

반환값:

null 또는 비어있는 가능성이 있는 KeyEventDispatchers List

관련 항목:

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

addKeyEventPostProcessor

public void addKeyEventPostProcessor(KeyEventPostProcessor  processor)

이 KeyboardFocusManager 포스트프로세서 체인에 KeyEventPostProcessor를 추가합니다. KeyEvent가 디스패치 되어 그 타겟으로 따라 처리되면, KeyboardFocusManager는 각 KeyEventPostProcessor 이 KeyEvent 최종 변환의 일부로서 필요한 사후 처리를 실행하도록 요구합니다. KeyEventPostProcessors는 추가된 순서로 통지됩니다. 현재의 KeyboardFocusManager는 마지막에 통지됩니다. 통지는 1개의 KeyEventPostProcessor가 그 postProcessKeyEvent 메서드로부터 true를 돌려주자마자 정지합니다. 추가되는 KeyEventPostProcessors 총수에 제한은 없습니다. 또, 특정의 KeyEventPostProcessor 인스턴스에 추가되는 회수에도 제한은 없습니다.

포스트프로세서가 null 로 지정되면, 처리는 행해지지 않고, 예외는 Throw 되지 않습니다.

파라미터:

processor - 포스트프로세서의 체인에 추가하는 KeyEventPostProcessor

관련 항목:

removeKeyEventPostProcessor(java.awt.KeyEventPostProcessor)

removeKeyEventPostProcessor

public void removeKeyEventPostProcessor(KeyEventPostProcessor  processor)

이 KeyboardFocusManager 포스트프로세서의 체인으로부터, 이전에 추가된 KeyEventPostProcessor를 삭제합니다. 이 KeyboardFocusManager 자체는 체인으로부터 완전하게는 삭제할 수 없습니다. addKeyEventPostProcessor를 통해서 행해진 추가 참조만이 삭제됩니다.

포스트프로세서가 null 로 지정되었을 경우, 지정된 포스트프로세서가 포스트프로세서 체인에 없는 경우, 또는 이 KeyboardFocusManager가 명시적으로 추가되지 않고 로 지정되었을 경우, 처리는 행해지지 않고, 예외는 Throw 되지 않습니다.

파라미터:

processor - 포스트프로세서의 체인으로부터 삭제하는 KeyEventPostProcessor

관련 항목:

addKeyEventPostProcessor(java.awt.KeyEventPostProcessor)

getKeyEventPostProcessors

protected List <KeyEventPostProcessor > getKeyEventPostProcessors()

이 KeyboardFocusManager KeyEventPostProcessor 체인을 List 로서 리턴합니다. 이 List 에는 addKeyEventPostProcessor에 의 호출을 통해서 명시적으로 재등록되었을 경우 이외는 이 KeyboardPostProcessors는 포함되지 않습니다. 그 외의 KeyEventPostProcessor가 등록되지 않는 경우, 구현은 null 또는 길이 0 List를 자유롭게 리턴합니다. 클라이언트 코드는 다른 동작을 있는 동작이라고 상정하거나 일단 확립된 동작은 변경되지 않으면 상정하거나 해서는 안됩니다.

반환값:

null 또는 비어있는 가능성이 있는 KeyEventPostProcessors List

관련 항목:

addKeyEventPostProcessor(java.awt.KeyEventPostProcessor), removeKeyEventPostProcessor(java.awt.KeyEventPostProcessor)

dispatchEvent

public abstract boolean dispatchEvent(AWTEvent  e)

이 메서드는 AWT 이벤트 디스팻쳐에 의해 불려가 현재의 KeyboardFocusManager가 그 메서드 대신에 지정된 이벤트를 디스패치 하도록 요구합니다. 모든 KeyboardFocusManagers는 모든 FocusEvents, 포커스에 관련한 모든 WindowEvents 및 모든 KeyEvents를 디스패치 하는 것과 상정되고 있습니다. 이러한 이벤트는 포커스의 소유자 및 포커스 된 활성화된 Windows에 대한 KeyboardFocusManager 개념에 근거해 디스패치 될 필요가 있습니다. 이것에 의해 지정된 AWTEvent 소스가 덧쓰기되는 경우가 있습니다. 디스패치는 redispatchEvent를 사용해 실행해, AWT 이벤트 디스팻쳐에 대해서 KeyboardFocusManager가 재차 이벤트를 재귀적으로 호출하는 요구를 하지 않게 할 필요가 있습니다. 이 메서드가 false를 돌려주면, AWT 이벤트 디스팻쳐는 이벤트 자체를 디스패치 하려고 시도합니다.

파라미터:

e - 디스패치 하는 AWTEvent

반환값:

이 메서드가 이벤트를 디스패치 했을 경우는 true, 그렇지 않은 경우는 false

관련 항목:

redispatchEvent(java.awt.Component, java.awt.AWTEvent), dispatchKeyEvent(java.awt.event.KeyEvent)

redispatchEvent

public final void redispatchEvent(Component  target,
                                  AWTEvent  e)

AWT 이벤트 디스팻쳐에 대해서 KeyboardFocusManager, 또는 인스톨 된 임의의 KeyEventDispatchers가 재차 이벤트를 재귀적으로 디스패치 하는 것을 요구하지 않는 것 같은 방법으로 AWTEvent를 재디스패치 합니다. dispatchEvent 및 클라이언트 정의의 KeyEventDispatchers 클라이언트의 구현은 target.dispatchEvent(e) 대신에 redispatchEvent(target, e)를 호출해 이벤트를 디스패치 할 필요가 있습니다.

이 메서드는 KeyboardFocusManagers 및 KeyEventDispatchers 전용입니다. 일반적인 클라이언트가 사용하는 것이 아닙니다.

파라미터:

target - 이벤트를 디스패치 하는 Component

e - 디스패치 하는 이벤트

관련 항목:

dispatchEvent(java.awt.AWTEvent), KeyEventDispatcher

dispatchKeyEvent

public abstract boolean dispatchKeyEvent(KeyEvent  e)

디스팻쳐 체인외의 KeyEventDispatcher가 KeyEvent를 디스패치 하지 않았던 경우, 또는 그 밖에 KeyEventDispatchers가 등록되지 않은 경우, 보통 이 메서드가 dispatchEvent에 의해 호출합니다. 이 메서드의 구현이 false를 돌려주는 경우, dispatchEvent는 KeyEvent 자체를 디스패치 하려고 하는지, 또는 단지 false를 리턴합니다. true가 리턴된인 경우, dispatchEvent는과 같이 true를 리턴합니다.

정의:

인터페이스 KeyEventDispatcher 내의 dispatchKeyEvent

파라미터:

e - 현재의 KeyboardFocusManager 로 이 KeyEventDispatcher가 디스패치 하는 것을 요구한 KeyEvent

반환값:

KeyEvent가 디스패치 되었을 경우는 true, 그렇지 않은 경우는 false

관련 항목:

dispatchEvent(java.awt.AWTEvent)

postProcessKeyEvent

public abstract boolean postProcessKeyEvent(KeyEvent  e)

이 메서드는 dispatchKeyEvent에 의해 호출합니다. 디폴트에서는 이 메서드는 이벤트를 소비해 쇼트 컷을 액티브화하는 것으로 임의의 소비되지 않는 KeyEvents가 AWT MenuShortcut에 매핑 되도록 처리합니다.

정의:

인터페이스 KeyEventPostProcessor 내의 postProcessKeyEvent

파라미터:

e - 프로세스 종료후의 KeyEvent

반환값:

다른 KeyEventPostProcessor가 KeyEvent에 대해 통지되지 않는 것을 나타내는 true

관련 항목:

dispatchKeyEvent(java.awt.event.KeyEvent), MenuShortcut

processKeyEvent

public abstract void processKeyEvent(Component  focusedComponent,
                                     KeyEvent  e)

KeyEvent가 지정된 focusedComponent에 대해서 포커스 traversal 키를 나타내는 경우에게만, 이 메서드는 포커스 traversal 조작을 초기화합니다. focusedComponent가 현재의 포커스의 소유자이라고 상정됩니다만, 반드시 이 대로인 필요는 없습니다. 이것이 그대로가 아닌 경우에서도, 포커스 traversal는 focusedComponent가 현재의 포커스의 소유자이도록 의해 처리를 계속합니다.

파라미터:

focusedComponent - 지정된 이벤트가 Component 포커스 traversal을 나타내는 경우, 포커스 traversal 조작의 기준이 되는 Component

e - 포커스 traversal 키를 나타내는 이벤트

enqueueKeyEvents

protected abstract void enqueueKeyEvents(long after,
                                         Component  untilFocused)

지정된 Component가 포커스의 소유자가 될 때까지, KeyEvents 디스패치를 지연 시킬 필요가 있는 것을 KeyboardFocusManager에 통지하기 위해서 AWT에 의해 호출합니다. 클라이언트 코드가 포커스의 변경을 요구하는 경우 및 AWT가 이 요구는 네이티브의 윈도우 처리 시스템에 의해 허가되는 것이라고 판정하는 경우는 AWT는 이 메서드를 호출합니다. 지정되었을 때 각표시보다 늦은 시각표시를 가지는 KeyEvents 디스패치를, 지정된 Component가 FOCUS_GAINED 이벤트를 받는지, 또는 AWT가 dequeueKeyEvents 또는 discardKeyEvents를 호출해 지연 요구를 취소할 때까지 지연 시키는 것은 KeyboardFocusManager 책임입니다.

파라미터:

after - 현재의 이벤트의 시각표시, 또는 현재의 이벤트가 시각표시를 가지지 않는 경우, 혹은 AWT가 현재 어느 이벤트가 처리되고 있을까 판단할 수 없는 경우는 현재의 시스템의 시간

untilFocused - 보류 상태에 있는 KeyEvents를 받기 전에 FOCUS_GAINED를 받는 Component

관련 항목:

dequeueKeyEvents(long, java.awt.Component), discardKeyEvents(java.awt.Component)

dequeueKeyEvents

protected abstract void dequeueKeyEvents(long after,
                                         Component  untilFocused)

지연 한 KeyEvents 디스패치를 취소하도록 KeyboardFocusManager에 통지하기 위해서 AWT에 의해 호출합니다. 같은 시각표시와 Component를 가지는 enqueueKeyEvents에 의 호출을 위해, 큐에 넣어진 모든 KeyEvents는 현재의 포커스의 소유자에게 보통 대로 디스패치 하기 위해서 해방될 필요가 있습니다. 지정되었을 때 각표시가 제로보다 작은 경우, 지정된 가장 낡은 시각표시를 가지는 Component에 대한 미처리의 엔큐 요구가 있는 경우는 삭제될 필요가 있습니다.

파라미터:

after - enqueueKeyEvents에 의 호출로 지정되었을 때 각표시, 또는 0 보다 작은 임의의 값

untilFocused - enqueueKeyEvents에 의 호출로 지정된 Component

관련 항목:

enqueueKeyEvents(long, java.awt.Component), discardKeyEvents(java.awt.Component)

discardKeyEvents

protected abstract void discardKeyEvents(Component  comp)

지연 한 KeyEvents 디스패치를 취소하도록 KeyboardFocusManager에 통지하기 위해서 AWT에 의해 호출합니다. 같은 Component를 가지는 enqueueKeyEvents에 의 1회 이상의 호출을 위해서 큐에 넣어진 모든 KeyEvents는 파기될 필요가 있습니다.

파라미터:

comp - enqueueKeyEvents에 의 1회 이상의 호출로 지정된 Component

관련 항목:

enqueueKeyEvents(long, java.awt.Component), dequeueKeyEvents(long, java.awt.Component)

focusNextComponent

public abstract void focusNextComponent(Component  aComponent)

보통 FocusTraversalPolicy에 기반해 aComponent 나중에 Component를 포커스 합니다.

파라미터:

aComponent - 포커스 traversal 조작의 기준이 되는 Component

관련 항목:

FocusTraversalPolicy

focusPreviousComponent

public abstract void focusPreviousComponent(Component  aComponent)

보통 FocusTraversalPolicy에 기반해 aComponent 전에 Component를 포커스 합니다.

파라미터:

aComponent - 포커스 traversal 조작의 기준이 되는 Component

관련 항목:

FocusTraversalPolicy

upFocusCycle

public abstract void upFocusCycle(Component  aComponent)

포커스를 1개 상의 포커스 traversal 사이클로 이동합니다. 보통, 포커스의 소유자는 aComponent 포커스 사이클의 루트로 설정되어 현재의 포커스 사이클의 루트는 새로운 포커스의 소유자의 포커스 사이클의 루트로 설정됩니다. 다만, aComponent 포커스 사이클의 루트가 Window인 경우는 보통 포커스의 소유자는 포커스 하는 Window 디폴트의 Component 로 설정되어 현재의 포커스 사이클의 루트는 변경되지 않습니다.

파라미터:

aComponent - 포커스 traversal 조작의 기준이 되는 Component

downFocusCycle

public abstract void downFocusCycle(Container  aContainer)

포커스를 1개 하의 포커스 traversal 사이클로 이동합니다. 보통, aContainer가 포커스 사이클의 루트의 경우, 포커스의 소유자는 포커스 하는 aContainer 디폴트의 Component 로 설정되어 현재의 포커스 사이클의 루트는 aContainer 로 설정됩니다. aContainer가 포커스 사이클의 루트가 아닌 경우, 포커스 traversal 조작은 행해지지 않습니다.

파라미터:

aContainer - 포커스 traversal 조작의 기준이 되는 Container

focusNextComponent

public final void focusNextComponent()

현재의 포커스의 소유자의 뒤에 Component를 포커스 합니다.

focusPreviousComponent

public final void focusPreviousComponent()

현재의 포커스의 소유자의 앞에 Component를 포커스 합니다.

upFocusCycle

public final void upFocusCycle()

포커스를 현재의 포커스의 소유자로부터 1개 상의 포커스 traversal 사이클로 이동합니다. 보통, 새로운 포커스의 소유자는 현재의 포커스의 소유자의 포커스 사이클의 루트로 설정되어 현재의 포커스 사이클의 루트는 새로운 포커스의 소유자의 포커스 사이클의 루트로 설정됩니다. 다만, 현재의 포커스의 소유자의 포커스 사이클의 루트가 Window인 경우, 보통 포커스의 소유자는 포커스 하는 포커스 사이클의 루트의 디폴트 Component 로 설정되어 현재의 포커스 사이클의 루트는 변경되지 않습니다.

downFocusCycle

public final void downFocusCycle()

현재의 포커스의 소유자가 포커스 사이클의 루트인 Container인 경우에게만, 포커스를 현재의 포커스의 소유자로부터 1개 하의 포커스 traversal 사이클로 이동합니다. 보통, 포커스의 소유자는 포커스 하는 현재의 포커스의 소유자의 디폴트의 Component 로 설정되어 현재의 포커스 사이클의 루트는 현재의 포커스의 소유자로 설정됩니다. 현재의 포커스의 소유자가 포커스 사이클의 루트인 Container가 아닌 경우는 포커스 traversal 조작은 행해지지 않습니다.