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 키를 무효로 하려면 , 빈 상태(empty)의 Set 를 사용합니다. Collections.EMPTY_SET 의 사용을 추천합니다.

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

파라미터:

id - 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 의 머지않아도 아닌 경우, keystrokes 가 null 의 경우, keystrokes 에 null 가 포함되는 경우, keystrokes 내의 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 를 가지지 않는 이러한 Windows 의 임의의 아이 Component 에 의해 재귀적으로 상속됩니다. 모든 조작의 설명은 setDefaultFocusTraversalKeys 를 참조해 주세요.

파라미터:

id - 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와 같은 문맥에 있는 경우, 현재의 포커스 사이클의 루트를 돌려줍니다. 포커스의 소유자 자체가 포커스 사이클의 루트의 경우, 일반적으로의 포커스 횡단(traverse)의 사이에 어느 Component 가 다음 또는 직전의 Component 를 나타낼까에 임해서, 애매하게 되는 경우가 있습니다. 이 경우는, 현재의 포커스 사이클의 루트를 사용해, 가능성이 있는 Component 로부터 식별합니다.

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

반환값:

현재의 포커스 사이클의 루트, 또는 현재의 포커스 사이클의 루트가 호출측 thread의 문맥의 멤버가 아닌 경우는 null

관련 항목:

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

getGlobalCurrentFocusCycleRoot

protected Container  getGlobalCurrentFocusCycleRoot()
                                            throws SecurityException 

호출측 thread가 현재의 포커스 사이클의 루트와 다른 문맥에 있는 경우에서도, 현재의 포커스 사이클의 루트를 돌려줍니다. 포커스의 소유자 자체가 포커스 사이클의 루트의 경우, 일반적으로의 포커스 횡단(traverse)의 사이에 어느 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)

현재의 포커스 사이클의 루트를 설정합니다. 포커스의 소유자 자체가 포커스 사이클의 루트의 경우, 일반적으로의 포커스 횡단(traverse)의 사이에 어느 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 의 경우는, 예외는 throw 되지 않고, 아무것도 처리는 없습니다.

파라미터:

listener - 추가하는 PropertyChangeListener

관련 항목:

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

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener  listener)

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

listener 가 null 의 경우는, 예외는 throw 되지 않고, 아무것도 처리는 없습니다.

파라미터:

listener - 삭제하는 PropertyChangeListener

관련 항목:

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

getPropertyChangeListeners

public PropertyChangeListener [] getPropertyChangeListeners()

이 키보드 포커스 매니저에게 등록된 모든 프로퍼티 변경 청취자의 배열을 돌려줍니다.

반환값:

이 키보드 포커스 매니저의 모든 PropertyChangeListener, 또는 현재 프로퍼티 변경 청취자가 등록되지 않은 경우는 빈 상태(empty)의 배열

도입된 버젼:

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 의 경우는, 예외는 throw 되지 않고, 아무것도 처리는 없습니다.

파라미터:

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 의 경우는, 예외는 throw 되지 않고, 아무것도 처리는 없습니다.

파라미터:

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, 청취자가 등록되지 않은 경우는 빈 상태(empty)의 배열

도입된 버젼:

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 의 경우는, 예외는 throw 되지 않고, 아무것도 처리는 없습니다.

파라미터:

listener - 추가하는 VetoableChangeListener

관련 항목:

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

removeVetoableChangeListener

public void removeVetoableChangeListener(VetoableChangeListener  listener)

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

listener 가 null 의 경우는, 예외는 throw 되지 않고, 아무것도 처리는 없습니다.

파라미터:

listener - 삭제하는 VetoableChangeListener

관련 항목:

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

getVetoableChangeListeners

public VetoableChangeListener [] getVetoableChangeListeners()

이 키보드 포커스 매니저에게 등록된 모든 거부 가능 변경 청취자의 배열을 돌려줍니다.

반환값:

이 키보드 포커스 매니저의 모든 VetoableChangeListener, 또는 현재 거부 가능 변경 청취자가 등록되지 않은 경우는 빈 상태(empty)의 배열

도입된 버젼:

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 의 경우는, 예외는 throw 되지 않고, 아무것도 처리는 없습니다.

파라미터:

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

listener - 추가하는 VetoableChangeListener

관련 항목:

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

removeVetoableChangeListener

public void removeVetoableChangeListener(String  propertyName,
                                         VetoableChangeListener  listener)

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

listener 가 null 의 경우는, 예외는 throw 되지 않고, 아무것도 처리는 없습니다.

파라미터:

propertyName - 유효한 프로퍼티명

listener - 삭제하는 VetoableChangeListener

관련 항목:

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

getVetoableChangeListeners

public VetoableChangeListener [] getVetoableChangeListeners(String  propertyName)

이름 첨부 프로퍼티에 관련지을 수 있던 모든 VetoableChangeListener 의 배열을 돌려줍니다.

반환값:

이름 첨부 프로퍼티에 관련지을 수 있던 모든 VetoableChangeListener, 청취자가 등록되지 않은 경우는 빈 상태(empty)의 배열

도입된 버젼:

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 가 낡은 값에 되돌려져 예외가 재throw 됩니다. 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 되지 않습니다.

multi-thread 어플리케이션에서는,KeyEventDispatcher 의 동작은, 다른 AWT 청취자와 같습니다. 상세한 것에 대하여는,「AWT Threading Issues」를 참조해 주세요.

파라미터:

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

관련 항목:

removeKeyEventDispatcher(java.awt.KeyEventDispatcher)

removeKeyEventDispatcher

public void removeKeyEventDispatcher(KeyEventDispatcher  dispatcher)

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

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

multi-thread 어플리케이션에서는,KeyEventDispatcher 의 동작은, 다른 AWT 청취자와 같습니다. 상세한 것에 대하여는,「AWT Threading Issues」를 참조해 주세요.

파라미터:

dispatcher - 디스펫쳐 체인으로부터 삭제한다 KeyEventDispatcher

관련 항목:

addKeyEventDispatcher(java.awt.KeyEventDispatcher)

getKeyEventDispatchers

protected List <KeyEventDispatcher > getKeyEventDispatchers()

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

반환값:

null 또는 빈 상태(empty)의 가능성이 있는 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 되지 않습니다.

multi-thread 어플리케이션에서는,KeyEventPostProcessor 의 동작은, 다른 AWT 청취자와 같습니다. 상세한 것에 대하여는,「AWT Threading Issues」를 참조해 주세요.

파라미터:

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

관련 항목:

removeKeyEventPostProcessor(java.awt.KeyEventPostProcessor)

removeKeyEventPostProcessor

public void removeKeyEventPostProcessor(KeyEventPostProcessor  processor)

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

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

multi-thread 어플리케이션에서는,KeyEventPostProcessor 의 동작은, 다른 AWT 청취자와 같습니다. 상세한 것에 대하여는,「AWT Threading Issues」를 참조해 주세요.

파라미터:

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

관련 항목:

addKeyEventPostProcessor(java.awt.KeyEventPostProcessor)

getKeyEventPostProcessors

protected List <KeyEventPostProcessor > getKeyEventPostProcessors()

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

반환값:

null 또는 빈 상태(empty)의 가능성이 있는 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

반환값:

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

관련 항목:

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 조작은 행해지지 않습니다.