JavaTM Platform
Standard Ed. 6

java.awt.event
클래스 WindowEvent

java.lang.Object 
  상위를 확장 java.util.EventObject 
      상위를 확장 java.awt.AWTEvent 
          상위를 확장 java.awt.event.ComponentEvent 
              상위를 확장 java.awt.event.WindowEvent
모든 구현된 인터페이스:
Serializable


public class WindowEvent
extends ComponentEvent

윈도우 상태가 바뀐 것을 나타내는 저레벨의 이벤트입니다. 이 저레벨 이벤트는, 윈도우가 오픈, 클로즈, 액티브화, 비액티브화, 아이콘화, 비아이콘화 되었을 때, 또는, 포커스가 Window 로 이동하든가, 혹은 Window 로부터 이동했을 때에 Window 객체에 의해 생성됩니다.  

발생한 이벤트는, 윈도우의 addWindowListener 메소드를 사용해, 그 이벤트를 받도록(듯이) 등록되어 있는 WindowListener 객체 또는 WindowAdapter 객체에게 건네집니다. (WindowAdapter 객체는,WindowListener 인터페이스를 구현하고 있습니다. 각각의 청취자 객체는, 이벤트가 발생하면(자), 이 WindowEvent 를 가져옵니다.

도입된 버젼:
JDK1. 1
관련 항목:
WindowAdapter , WindowListener , 「Tutorial: Writing a Window Listener」, 직렬화 된 형식

필드의 개요
static int WINDOW_ACTIVATED
          윈도우가 액티브하게 된 것을 나타내는 이벤트형입니다.
static int WINDOW_CLOSED
          윈도우가 클로즈 된 것을 나타내는 이벤트입니다.
static int WINDOW_CLOSING
          윈도우를 클로즈 하고 있는 것을 나타내는 이벤트입니다.
static int WINDOW_DEACTIVATED
          윈도우가 액티브하지 않게 된 것을 나타내는 이벤트형입니다.
static int WINDOW_DEICONIFIED
          윈도우가 비아이콘화 된 것을 나타내는 이벤트형입니다.
static int WINDOW_FIRST
          윈도우 이벤트 식별자의 범위를 나타내는 최초의 번호입니다.
static int WINDOW_GAINED_FOCUS
          윈도우가 포커스를 취득한 것을 나타내는 이벤트형입니다.
static int WINDOW_ICONIFIED
          윈도우가 아이콘화 된 것을 나타내는 이벤트입니다.
static int WINDOW_LAST
          윈도우 이벤트 식별자의 범위를 나타내는 마지막 번호입니다.
static int WINDOW_LOST_FOCUS
          윈도우가 포커스를 상실한 것을 나타내는 이벤트형입니다.
static int WINDOW_OPENED
          윈도우가 오픈된 것을 나타내는 이벤트입니다.
static int WINDOW_STATE_CHANGED
          윈도우 상태가 변경된 것을 나타내는 이벤트형입니다.
 
클래스 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
 
생성자 의 개요
WindowEvent (Window  source, int id)
          WindowEvent 객체를 구축합니다.
WindowEvent (Window  source, int id, int oldState, int newState)
          지정된 이전의 윈도우 상태와 새로운 윈도우 상태를 사용해,WindowEvent 를 구축합니다.
WindowEvent (Window  source, int id, Window  opposite)
          지정된 반대의 Window 로 WindowEvent 객체를 구축합니다.
WindowEvent (Window  source, int id, Window  opposite, int oldState, int newState)
          WindowEvent 객체를 구축합니다.
 
메소드의 개요
 int getNewState ()
          WINDOW_STATE_CHANGED 이벤트의 경우, 윈도우의 새로운 상태가 돌려주어집니다.
 int getOldState ()
          WINDOW_STATE_CHANGED 이벤트의 경우, 이전의 윈도우 상태를 돌려줍니다.
 Window getOppositeWindow ()
          이 포커스 또는 액티베이션 변경에 관련하는 이제(벌써) 한편의 Window 를 돌려줍니다.
 Window getWindow ()
          이벤트의 발생원을 돌려줍니다.
 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
 

필드의 상세

WINDOW_FIRST

public static final int WINDOW_FIRST
윈도우 이벤트 식별자의 범위를 나타내는 최초의 번호입니다.

관련 항목:
정수 필드치

WINDOW_OPENED

public static final int WINDOW_OPENED
윈도우가 오픈된 것을 나타내는 이벤트입니다. 이 이벤트는, 윈도우가 최초로 가시화 되었을 때에만 송신됩니다.

관련 항목:
정수 필드치

WINDOW_CLOSING

public static final int WINDOW_CLOSING
윈도우를 클로즈 하고 있는 것을 나타내는 이벤트입니다. 이 이벤트는, 사용자가 윈도우의 시스템 메뉴로 윈도우를 닫으려고 했을 때에 송신됩니다. 이 이벤트를 처리할 때에, 프로그램이 명시적으로 윈도우의 비표시도 파기도 실시하지 않는 경우, 윈도우 클로즈의 조작은 삭제됩니다.

관련 항목:
정수 필드치

WINDOW_CLOSED

public static final int WINDOW_CLOSED
윈도우가 클로즈 된 것을 나타내는 이벤트입니다. 이 이벤트는, dispose 메소드의 호출의 결과, 윈도우가 클로즈 된 후에 생성됩니다.

관련 항목:
정수 필드치

WINDOW_ICONIFIED

public static final int WINDOW_ICONIFIED
윈도우가 아이콘화 된 것을 나타내는 이벤트입니다. 이 이벤트는, 윈도우가 일반적으로 상태로부터 최소화된 상태로 변경되었을 때에 송신됩니다. 많은 플랫폼에 대해, 최소화된 윈도우는, 그 윈도우의 iconImage 프로퍼티으로 지정된 아이콘으로서 표시됩니다.

관련 항목:
Frame.setIconImage(java.awt.Image) , 정수 필드치

WINDOW_DEICONIFIED

public static final int WINDOW_DEICONIFIED
윈도우가 비아이콘화 된 것을 나타내는 이벤트형입니다. 이 이벤트는, 윈도우가 최소화된 상태로부터 일반적으로 상태로 변경되었을 때에 송신됩니다.

관련 항목:
정수 필드치

WINDOW_ACTIVATED

public static final int WINDOW_ACTIVATED
윈도우가 액티브하게 된 것을 나타내는 이벤트형입니다. 이 이벤트는 Window 가 액티브 Window 가 되었을 때에 송신됩니다. Frame 또는 Dialog 만이 액티브 Window 가 됩니다. 네이티브의 윈도우 처리 시스템은, 액티브 Window 또는 하이라이트 된 타이틀 바 등 특별한 장식을 가지는 그 아이를 나타냅니다. 액티브 Window 는, 항상, 포커스 된 Window 인가, 또는 포커스 된 Window 의 오너인 최초의 Frame 또는 Dialog 의 머지않아인가입니다.

관련 항목:
정수 필드치

WINDOW_DEACTIVATED

public static final int WINDOW_DEACTIVATED
윈도우가 액티브하지 않게 된 것을 나타내는 이벤트형입니다. 이 이벤트는 Window 가 액티브 Window 가 아니게 되었을 때에 송신됩니다. Frame 또는 Dialog 만이 액티브 Window 가 됩니다. 네이티브의 윈도우 처리 시스템은, 액티브 Window 또는 하이라이트 된 타이틀 바 등 특별한 장식을 가지는 그 아이를 나타냅니다. 액티브 Window 는, 항상, 포커스 된 Window 인가, 또는 포커스 된 Window 의 오너인 최초의 Frame 또는 Dialog 의 머지않아인가입니다.

관련 항목:
정수 필드치

WINDOW_GAINED_FOCUS

public static final int WINDOW_GAINED_FOCUS
윈도우가 포커스를 취득한 것을 나타내는 이벤트형입니다. 이 이벤트는, Window 가 포커스 된 Window 가 되었을 때에 송신됩니다. 이것은, 그 Window 또는 그 서브 컴퍼넌트의 하나가 키보드 이벤트를 받게 된 것을 의미합니다.

관련 항목:
정수 필드치

WINDOW_LOST_FOCUS

public static final int WINDOW_LOST_FOCUS
윈도우가 포커스를 상실한 것을 나타내는 이벤트형입니다. 이 이벤트는, Window 가 포커스 된 Window 가 아니게 되었을 때에 송신됩니다. 이것은, 키보드 이벤트가 그 Window 또는 그 서브 컴퍼넌트에 송신되지 않게 되는 것을 의미합니다.

관련 항목:
정수 필드치

WINDOW_STATE_CHANGED

public static final int WINDOW_STATE_CHANGED
윈도우 상태가 변경된 것을 나타내는 이벤트형입니다. 이 이벤트는, Window 상태가 변경되었을 때 (아이콘화, 최대화등)에 송신됩니다.

도입된 버젼:
1.4
관련 항목:
정수 필드치

WINDOW_LAST

public static final int WINDOW_LAST
윈도우 이벤트 식별자의 범위를 나타내는 마지막 번호입니다.

관련 항목:
정수 필드치
생성자 의 상세

WindowEvent

public WindowEvent(Window  source,
                   int id,
                   Window  opposite,
                   int oldState,
                   int newState)
WindowEvent 객체를 구축합니다.  

무효인 id 를 건네주어, 특정할 수 없는 동작을 발생시키지 않게 해 주세요. 이 메소드는 source 가 null 의 경우에 IllegalArgumentException 를 throw 합니다.

파라미터:
source - 이벤트의 발생원의 Window 객체
id - 이벤트의 형태를 나타내는 정수
opposite - 포커스 또는 액티베이션 변경에 관련하는 이제(벌써) 한편의 윈도우, 또는 null
oldState - 윈도우 상태 변경 이벤트 발생전의 윈도우 상태
newState - 윈도우 상태 변경 이벤트 발생 후의 새로운 윈도우 상태
예외:
IllegalArgumentException - source 가 null 의 경우
도입된 버젼:
1.4

WindowEvent

public WindowEvent(Window  source,
                   int id,
                   Window  opposite)
지정된 반대의 Window 로 WindowEvent 객체를 구축합니다. 이 반대의 Window 는, 이 포커스 또는 액티베이션의 변경에 포함되는 이제(벌써) 한편의 Window 입니다. WINDOW_ACTIVATED 또는 WINDOW_GAINED_FOCUS 이벤트의 경우, 이것은 액티베이션 또는 포커스를 상실한 Window 입니다. WINDOW_DEACTIVATED 또는 WINDOW_LOST_FOCUS 이벤트의 경우, 이것은 액티베이션 또는 포커스를 취득한 Window 입니다. 이 포커스 변경이, 네이티브 어플리케이션이나 다른 VM 의 Java 어플리케이션을 사용하는지, 또는 이제 한편의 Window 를 전혀 사용하지 않고에 행해지는 경우, 반대의 Window 는 null 가 됩니다.  

무효인 id 를 건네주어, 특정할 수 없는 동작을 발생시키지 않게 해 주세요. 이 메소드는 source 가 null 의 경우에 IllegalArgumentException 를 throw 합니다.

파라미터:
source - 이벤트의 발생원의 Window 객체
id - WINDOW_ACTIVATED, WINDOW_DEACTIVATED, WINDOW_GAINED_FOCUS, 또는 WINDOW_LOST_FOCUS. 이런 종류의 이벤트의 반대의 Window 는 항상 null 이기 (위해)때문에, 이 생성자 은 그 외의 WindowEvent 에서는 사용되지 않는다고 보여지는
opposite - 포커스 또는 액티베이션 변경에 관련하는 이제(벌써) 한편의 Window, 또는 null
예외:
IllegalArgumentException - source 가 null 의 경우
도입된 버젼:
1.4

WindowEvent

public WindowEvent(Window  source,
                   int id,
                   int oldState,
                   int newState)
지정된 이전의 윈도우 상태와 새로운 윈도우 상태를 사용해,WindowEvent 를 구축합니다.  

무효인 id 를 건네주어, 특정할 수 없는 동작을 발생시키지 않게 해 주세요. 이 메소드는 source 가 null 의 경우에 IllegalArgumentException 를 throw 합니다.

파라미터:
source - 이벤트의 발생원의 Window 객체
id - WINDOW_STATE_CHANGED 이벤트형. 이전의 윈도우와 새로운 윈도우 상태가, 그 외의 이벤트형에 있어 무의미하기 때문에, 이 생성자 은, 그 외의 WindowEvent 형에서는 사용되지 않는다고 보여지는
oldState - 이전의 윈도우 상태를 나타내는 정수
newState - 새로운 윈도우 상태를 나타내는 정수
예외:
IllegalArgumentException - source 가 null 의 경우
도입된 버젼:
1.4

WindowEvent

public WindowEvent(Window  source,
                   int id)
WindowEvent 객체를 구축합니다.  

무효인 id 를 건네주어, 특정할 수 없는 동작을 발생시키지 않게 해 주세요. 이 메소드는 source 가 null 의 경우에 IllegalArgumentException 를 throw 합니다.

파라미터:
source - 이벤트의 발생원의 Window 객체
id - 이벤트의 형태를 나타내는 정수
예외:
IllegalArgumentException - source 가 null 의 경우
메소드의 상세

getWindow

public Window  getWindow()
이벤트의 발생원을 돌려줍니다.

반환값:
이벤트의 발생원의 Window 객체

getOppositeWindow

public Window  getOppositeWindow()
이 포커스 또는 액티베이션 변경에 관련하는 이제(벌써) 한편의 Window 를 돌려줍니다. WINDOW_ACTIVATED 또는 WINDOW_GAINED_FOCUS 이벤트의 경우, 이것은 액티베이션 또는 포커스를 상실한 Window 입니다. WINDOW_DEACTIVATED 또는 WINDOW_LOST_FOCUS 의 경우, 이것은 액티베이션 또는 포커스를 취득한 Window 입니다. 이 다른 모든 형태의 WindowEvent 의 경우, 혹은 포커스 또는 액티베이션이, 네이티브 어플리케이션이나 다른 VM 또는 문맥의 Java 어플리케이션을 사용하는지, 이제 한편의 Window 를 사용하지 않고 로 변경되었을 경우, null 가 돌려주어집니다.

반환값:
포커스 또는 액티베이션 변경에 관련하는 이제(벌써) 한편의 Window, 또는 null
도입된 버젼:
1.4

getOldState

public int getOldState()
WINDOW_STATE_CHANGED 이벤트의 경우, 이전의 윈도우 상태를 돌려줍니다. 이 프레임 상태를 비트 마스크로 돌려줍니다.

반환값:
이전의 윈도우 상태의 비트 단위 마스크
도입된 버젼:
1.4
관련 항목:
Frame.getExtendedState()

getNewState

public int getNewState()
WINDOW_STATE_CHANGED 이벤트의 경우, 윈도우의 새로운 상태가 돌려주어집니다. 이 프레임 상태를 비트 마스크로 돌려줍니다.

반환값:
새로운 윈도우 상태의 비트 단위 마스크
도입된 버젼:
1.4
관련 항목:
Frame.getExtendedState()

paramString

public String  paramString()
이 이벤트를 특정하는 파라미터의 캐릭터 라인을 돌려줍니다. 이 메소드는, 이벤트 로그의 작성 및 디버그에 사용합니다.

오버라이드(override):
클래스 ComponentEvent 내의 paramString
반환값:
이벤트를 특정하는 캐릭터 라인과 그 속성

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.