java.awt.event
클래스 FocusEvent

java.lang.Object 
  java.util.EventObject 
      java.awt.AWTEvent 
          java.awt.event.ComponentEvent 
              java.awt.event.FocusEvent

모든 구현된 인터페이스:

Serializable

public class FocusEvent
extends ComponentEvent 

Component가 입력초점을 취득 또는 잃은 것을 나타내는 저레벨의 이벤트입니다. 이 저레벨 이벤트는 TextField 등의 Component에 의해 생성됩니다. 발생한 이벤트는 Component addFocusListener 메서드를 사용해, 이런 종류의 이벤트를 받도록 등록되어 모든 FocusListener 객체 또는 FocusAdapter 객체에게 건네집니다 (FocusAdapter객체는 FocusListener인터페이스를 구현하고 있다). 각 리스너 객체는 이벤트가 발생했을 때에 FocusEvent를 취득합니다.

포커스 이벤트에는 영구와 텐포라리의 2개의 레벨이 있습니다. 영구 포커스 변경 이벤트는 requestFocus()를 호출하거나 사용자가 Tab 키를 사용해 Component를 traversal 하거나 하는 경우 등, 포커스가 있는 Component 로부터 다른 Component에 직접 이동할 경우에 발생합니다. 텐포라리포카스 변경 이벤트는 Window가 활성화되지 않게 되거나 스크롤 바를 드래그 하는 경우 등, 다른 조작의 간접적인 결과적으로 Component에 대한 포커스를 일시적으로 잃는 경우에 발생합니다. 이 경우 그 조작이 종료하면 원의 포커스 상태가 자동적으로 복원됩니다. 또, Window가 활성화되지 않게 되었을 경우에는 다시 활성화 되었을 때에 원의 포커스 상태가 자동적으로 복원됩니다. 영구 포커스 변경 이벤트와 텐포라리포카스 변경 이벤트는 양쪽 모두, FOCUS_GAINED와 FOCUS_LOST 이벤트 식별자를 사용해 발행됩니다. 이벤트의 레벨의 차이는 isTemporary() 메서드를 사용해 구별할 수 있습니다.

도입된 버전 :

1.1

관련 항목:

FocusAdapter, FocusListener, Tutorial: Writing a Focus Listener, Reference: The Java Class Libraries (update file), 직렬화 된 형식

필드 개요

static int	FOCUS_FIRST 포커스 이벤트 식별자에 사용하는 정수의 범위에 있는 최초의 번호입니다.
static int	FOCUS_GAINED 이 이벤트는 현재 Component가 포커스의 소유자인 것을 나타냅니다.
static int	FOCUS_LAST 포커스 이벤트 식별자에 사용하는 정수의 범위에 있는 마지막 번호입니다.
static int	FOCUS_LOST 이 이벤트는 현재 Component가 포커스의 소유자가 아닌 것을 나타냅니다.

클래스 java.awt.event. ComponentEvent 로부터 상속된 필드

COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN

클래스 java.awt. AWTEvent 로부터 상속된 필드

ACTION_EVENT_MASK, ADJUSTMENT_EVENT_MASK, COMPONENT_EVENT_MASK, consumed, CONTAINER_EVENT_MASK, FOCUS_EVENT_MASK, HIERARCHY_BOUNDS_EVENT_MASK, HIERARCHY_EVENT_MASK, id, INPUT_METHOD_EVENT_MASK, INVOCATION_EVENT_MASK, ITEM_EVENT_MASK, KEY_EVENT_MASK, MOUSE_EVENT_MASK, MOUSE_MOTION_EVENT_MASK, MOUSE_WHEEL_EVENT_MASK, PAINT_EVENT_MASK, RESERVED_ID_MAX, TEXT_EVENT_MASK, WINDOW_EVENT_MASK, WINDOW_FOCUS_EVENT_MASK, WINDOW_STATE_EVENT_MASK

클래스 java.util. EventObject 로부터 상속된 필드

source

생성자 개요

FocusEvent (Component source, int id)
FocusEvent 객체를 구축해, 포커스의 변경이 영구인가 어떤가를 판정합니다.

FocusEvent (Component source, int id, boolean temporary)
FocusEvent 객체를 구축해, 변경이 텐포라리인가 어떤가를 판정합니다.

FocusEvent (Component source, int id, boolean temporary, Component opposite)
지정된 텐포라리 상태로 반대의 Component를 가지는 FocusEvent 객체를 구축합니다.

메서드 개요

Component	getOppositeComponent () 이 포커스 변경에 관계된 이제(이미 ) 한편의 Component를 리턴합니다.
boolean	isTemporary () 포커스 변경 이벤트가 텐포라리인지, 영구인지를 나타냅니다.
String	paramString () 이 이벤트를 특정하는 파라미터의 캐릭터 라인을 리턴합니다.

클래스 java.awt.event. ComponentEvent 로부터 상속된 메서드

getComponent

클래스 java.awt. AWTEvent 로부터 상속된 메서드

consume, getID, isConsumed, setSource, toString

클래스 java.util. EventObject 로부터 상속된 메서드

getSource

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

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

필드의 상세

FOCUS_FIRST

public static final int FOCUS_FIRST

포커스 이벤트 식별자에 사용하는 정수의 범위에 있는 최초의 번호입니다.

관련 항목:

정수 필드값

FOCUS_LAST

public static final int FOCUS_LAST

포커스 이벤트 식별자에 사용하는 정수의 범위에 있는 마지막 번호입니다.

관련 항목:

정수 필드값

FOCUS_GAINED

public static final int FOCUS_GAINED

이 이벤트는 현재 Component가 포커스의 소유자인 것을 나타냅니다.

관련 항목:

정수 필드값

FOCUS_LOST

public static final int FOCUS_LOST

이 이벤트는 현재 Component가 포커스의 소유자가 아닌 것을 나타냅니다.

관련 항목:

정수 필드값

생성자 상세

FocusEvent

public FocusEvent(Component  source,
                  int id,
                  boolean temporary,
                  Component  opposite)

지정된 텐포라리 상태로 반대의 Component를 가지는 FocusEvent 객체를 구축합니다. 반대의 Component 란 포커스 변경에 관계된 이제(이미 ) 한편의 Component 입니다. FOCUS_GAINED 이벤트의 경우, 이것은 포커스를 잃은 Component 입니다. FOCUS_LOST인 경우, 이것은 포커스를 취득한 Component 입니다. 이 포커스 변경이, 네이티브 어플리케이션이나 다른 VM Java 어플리케이션으로 발생하는 경우, 또는 이제 한편의 Component를 전혀 사용하지 않고에 행해지는 경우는 반대의 Component는 null이 됩니다.

무효인 id를 건네주면, 특정할 수 없는 동작이 발생합니다. 이 메서드는 source가 null인 경우에 IllegalArgumentException을 Throw 합니다.

파라미터:

source - 이벤트의 발생원의 Component

id - FOCUS_GAINED 또는 FOCUS_LOST

temporary - 포커스 변경이 텐포라리의 경우는 true, 그렇지 않은 경우는 false

opposite - 포커스의 변경에 관계된 이제(이미 ) 한편의 Component, 또는 null

예외:

IllegalArgumentException - source가 null인 경우

FocusEvent

public FocusEvent(Component  source,
                  int id,
                  boolean temporary)

FocusEvent 객체를 구축해, 변경이 텐포라리인가 어떤가를 판정합니다.

무효인 id를 건네주면, 특정할 수 없는 동작이 발생합니다. 이 메서드는 source가 null인 경우에 IllegalArgumentException을 Throw 합니다.

파라미터:

source - 이벤트의 발생원의 Component

id - 이벤트의 형태를 나타내는 정수

temporary - 포커스 변경이 텐포라리의 경우는 true, 그렇지 않은 경우는 false

예외:

IllegalArgumentException - source가 null인 경우

FocusEvent

public FocusEvent(Component  source,
                  int id)

FocusEvent 객체를 구축해, 포커스의 변경이 영구인가 어떤가를 판정합니다.

무효인 id를 건네주면, 특정할 수 없는 동작이 발생합니다. 이 메서드는 source가 null인 경우에 IllegalArgumentException을 Throw 합니다.

파라미터:

source - 이벤트의 발생원의 Component

id - 이벤트의 형태를 나타내는 정수

예외:

IllegalArgumentException - source가 null인 경우

메서드의 상세

isTemporary

public boolean isTemporary()

포커스 변경 이벤트가 텐포라리인지, 영구인지를 나타냅니다.

반환값:

포커스 변경이 텐포라리의 경우는 true, 그렇지 않은 경우는 false

getOppositeComponent

public Component  getOppositeComponent()

이 포커스 변경에 관계된 이제(이미 ) 한편의 Component를 리턴합니다. FOCUS_GAINED 이벤트의 경우, 이것은 포커스를 잃은 Component 입니다. FOCUS_LOST 이벤트의 경우, 이것은 포커스를 취득한 Component 입니다. 이 포커스 변경이, 네이티브 어플리케이션, 또는 다른 VM 나 컨텍스트 의 Java 어플리케이션으로 발생하는 경우, 또는 이제 한편의 Component를 전혀 사용하지 않고에 행해지는 경우는 null이 리턴됩니다 .

반환값:

포커스 변경에 관계된 이제(이미 ) 한편의 Component, 또는 null

도입된 버전 :

1.4

paramString

public String  paramString()

이 이벤트를 특정하는 파라미터의 캐릭터 라인을 리턴합니다. 이 메서드는 이벤트 로그의 작성 및 디버그에 사용합니다.

오버라이드(override):

클래스 ComponentEvent 내의 paramString

반환값:

이벤트를 특정하는 캐릭터 라인과 그 속성