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)
          지정된 반대의 WindowWindowEvent 객체를 구축합니다.
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 를 건네주어, 특정할 수 없는 동작을 발생시키지 않게 해 주세요. 이 메소드는 sourcenull 의 경우에 IllegalArgumentException 를 throw 합니다.

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

WindowEvent

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

무효인 id 를 건네주어, 특정할 수 없는 동작을 발생시키지 않게 해 주세요. 이 메소드는 sourcenull 의 경우에 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 를 건네주어, 특정할 수 없는 동작을 발생시키지 않게 해 주세요. 이 메소드는 sourcenull 의 경우에 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 를 건네주어, 특정할 수 없는 동작을 발생시키지 않게 해 주세요. 이 메소드는 sourcenull 의 경우에 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 도 참조해 주세요.