java.awt.event
클래스 HierarchyEvent

java.lang.Object 
  java.util.EventObject 
      java.awt.AWTEvent 
          java.awt.event.HierarchyEvent

모든 구현된 인터페이스:

Serializable

public class HierarchyEvent
extends AWTEvent 

Component 가 소속하는 Component 계층의 변경을 나타내는 이벤트입니다.

• Hierarchy Change Events (HierarchyListener)
  • 상위 클래스의 추가
  • 상위 클래스의 삭제
  • 표시 가능한 계층
  • 표시 불가능한 계층
  • 가시 및 표시 가능한 화면에 표시되는 계층
  • 불가시 또는 표시 불가능한 화면상에 표시되지 않는 계층
• Ancestor Reshape Events (HierarchyBoundsListener)
  • 사이즈 변경된 상위 클래스
  • 이동된 상위 클래스

계층 이벤트는 통지의 목적에만 제공됩니다. AWT 는 계층의 변경을 내부적으로 자동으로 취급하므로, 프로그램이 계층 이벤트를 받을지 어떨지에 관계없이, GUI 의 레이아웃이나 표시 가능성은 올바르게 동작합니다.

이 이벤트는, 컨테이너가 추가, 삭제, 이동, 사이즈 변경되어, 해당 계층에게 건네졌을 때에, Panel 등의 Container 객체에 의해 생성됩니다. 또, 객체의 addNotify,removeNotify,show, 또는 hide 메소드가 불려 갔을 때에도, 이 이벤트는 Container 객체에 의해 생성됩니다. ANCESTOR_MOVED 및 ANCESTOR_RESIZED 이벤트는, Component 의 addHierarchyBoundsListener 메소드를 사용해, 이러한 이벤트를 받도록(듯이) 등록된 모든 HierarchyBoundsListener 또는 HierarchyBoundsAdapter 객체에 발송 됩니다 (HierarchyBoundsAdapter 객체는,HierarchyBoundsListener 인터페이스를 구현하고 있다). HIERARCHY_CHANGED 이벤트는, Component 의 addHierarchyListener 메소드를 사용해, 이러한 이벤트를 받도록(듯이) 등록된 모든 HierarchyListener 객체에 발송 됩니다. 이런 종류의 청취자 객체는 모두, 이벤트 발생시에 이 HierarchyEvent 를 가져옵니다.

도입된 버젼:

1.3

관련 항목:

HierarchyListener , HierarchyBoundsAdapter , HierarchyBoundsListener , 직렬화 된 형식

필드의 개요

static int	ANCESTOR_MOVED 상위 컨테이너가 이동된 것을 나타내는 이벤트 식별자입니다.
static int	ANCESTOR_RESIZED 상위 컨테이너가 사이즈 변경된 것을 나타내는 이벤트 식별자입니다.
static int	DISPLAYABILITY_CHANGED 계층의 표시 가능성의 변경에 의해,HIERARCHY_CHANGED 이벤트가 생성된 것을 나타냅니다.
static int	HIERARCHY_CHANGED 계층 트리 전체가 변경된 것을 나타내는 이벤트 식별자입니다.
static int	HIERARCHY_FIRST 계층 이벤트 식별자의 범위를 나타내는 최초의 번호입니다.
static int	HIERARCHY_LAST 상위 클래스의 이벤트 식별자를 나타내는 정수의 범위의, 마지막 번호입니다.
static int	PARENT_CHANGED HIERARCHY_CHANGED 이벤트가, 친설정 오퍼레이션에 의해 생성된 것을 나타냅니다.
static int	SHOWING_CHANGED 계층의 표시 상태의 변경에 의해,HIERARCHY_CHANGED 이벤트가 생성된 것을 나타냅니다.

클래스 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

생성자 의 개요

HierarchyEvent (Component source, int id, Component changed, Container changedParent)
HierarchyEvent 객체를 구축해,Component 계층의 변경을 식별합니다.

HierarchyEvent (Component source, int id, Component changed, Container changedParent, long changeFlags)
HierarchyEvent 객체를 구축해,Component 계층의 변경을 식별합니다.

메소드의 개요

Component	getChanged () 변경된 계층의 최상정도 Component 를 돌려줍니다.
Container	getChangedParent () getChanged() 가 돌려준 Component 의 부모를 돌려줍니다.
long	getChangeFlags () 이 이벤트 객체로 표현된 HIERARCHY_CHANGED 이벤트의 형태를 나타내는 비트 마스크를 돌려줍니다.
Component	getComponent () 이벤트의 발생원을 돌려줍니다.
String	paramString () 이 이벤트를 특정하는 파라미터의 캐릭터 라인을 돌려줍니다.

클래스 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

필드의 상세

HIERARCHY_FIRST

public static final int HIERARCHY_FIRST

계층 이벤트 식별자의 범위를 나타내는 최초의 번호입니다.

관련 항목:

정수 필드치

HIERARCHY_CHANGED

public static final int HIERARCHY_CHANGED

계층 트리 전체가 변경된 것을 나타내는 이벤트 식별자입니다.

관련 항목:

정수 필드치

ANCESTOR_MOVED

public static final int ANCESTOR_MOVED

상위 컨테이너가 이동된 것을 나타내는 이벤트 식별자입니다.

관련 항목:

정수 필드치

ANCESTOR_RESIZED

public static final int ANCESTOR_RESIZED

상위 컨테이너가 사이즈 변경된 것을 나타내는 이벤트 식별자입니다.

관련 항목:

정수 필드치

HIERARCHY_LAST

public static final int HIERARCHY_LAST

상위 클래스의 이벤트 식별자를 나타내는 정수의 범위의, 마지막 번호입니다.

관련 항목:

정수 필드치

PARENT_CHANGED

public static final int PARENT_CHANGED

HIERARCHY_CHANGED 이벤트가, 친설정 오퍼레이션에 의해 생성된 것을 나타냅니다.

관련 항목:

정수 필드치

DISPLAYABILITY_CHANGED

public static final int DISPLAYABILITY_CHANGED

계층의 표시 가능성의 변경에 의해,HIERARCHY_CHANGED 이벤트가 생성된 것을 나타냅니다. 현재의 계층의 표시 가능성을 판단하려면 ,Component.isDisplayable 를 호출합니다. 표시 가능성은 Component.addNotify 와 Component.removeNotify 의 명시적 또는 암묵적인 호출에 의해 변경됩니다.

관련 항목:

Component.isDisplayable() , Component.addNotify() , Component.removeNotify() , 정수 필드치

SHOWING_CHANGED

public static final int SHOWING_CHANGED

계층의 표시 상태의 변경에 의해,HIERARCHY_CHANGED 이벤트가 생성된 것을 나타냅니다. 현재의 계층의 표시 상태를 판단하려면 ,Component.isShowing 를 호출합니다. 계층의 표시 가능성 또는 가시성의 어느 쪽인지가 생성되면(자), 표시 상태의 변경이 생성됩니다. 가시성의 변경은,Component.show 및 Component.hide 의 명시적 또는 암묵적인 호출해에 대응해 생성됩니다.

관련 항목:

Component.isShowing() , Component.addNotify() , Component.removeNotify() , Component.show() , Component.hide() , 정수 필드치

생성자 의 상세

HierarchyEvent

public HierarchyEvent(Component  source,
                      int id,
                      Component  changed,
                      Container  changedParent)

HierarchyEvent 객체를 구축해,Component 계층의 변경을 식별합니다. 　

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

파라미터:

source - 이벤트의 발생원의 Component 객체

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

changed - 변경된 계층의 최상정도 Component

changedParent - changed 의 부모. 변경의 종류에 응해, 변경전 또는 변경 후의 부모가 된다

예외:

IllegalArgumentException - source 가 null 의 경우

HierarchyEvent

public HierarchyEvent(Component  source,
                      int id,
                      Component  changed,
                      Container  changedParent,
                      long changeFlags)

HierarchyEvent 객체를 구축해,Component 계층의 변경을 식별합니다. 　

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

파라미터:

source - 이벤트의 발생원의 Component 객체

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

changed - 변경된 계층의 최상정도 Component

changedParent - changed 의 부모. 변경의 종류에 응해, 변경전 또는 변경 후의 부모가 되는

changeFlags - 이 이벤트 객체로 표현되었다 HIERARCHY_CHANGED 이벤트의 형태를 나타내는 비트 마스크

예외:

IllegalArgumentException - source 가 null 의 경우

메소드의 상세

getComponent

public Component  getComponent()

이벤트의 발생원을 돌려줍니다.

반환값:

이벤트의 발생원의 Component 객체. 객체가 Container 가 아닌 경우는 null

getChanged

public Component  getChanged()

변경된 계층의 최상정도 Component 를 돌려줍니다.

반환값:

변경된 Component

getChangedParent

public Container  getChangedParent()

getChanged() 가 돌려준 Component 의 부모를 돌려줍니다. 변경이 Container.add 의 호출을 사용하는 PARENT_CHANGED 형의 HIERARCHY_CHANGED 이벤트의 경우, 추가 오퍼레이션 후의 부모가 돌려주어집니다. 변경이 Container.remove 의 호출을 사용하는 PARENT_CHANGED 형의 HIERARCHY_CHANGED 이벤트의 경우, 삭제 오퍼레이션의 전의 부모가 돌려주어집니다. 그 외의 모든 이벤트나 형태에서는, 오퍼레이션시의 부모가 돌려주어집니다.

반환값:

변경된 Component 의 부모

getChangeFlags

public long getChangeFlags()

이 이벤트 객체로 표현된 HIERARCHY_CHANGED 이벤트의 형태를 나타내는 비트 마스크를 돌려줍니다. 비트는, 비트 단위의 논리합입니다.

반환값:

비트 마스크. HIERARCHY_CHANGED 이벤트가 아닌 경우는 0

paramString

public String  paramString()

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

오버라이드(override):

클래스 AWTEvent 내의 paramString

반환값:

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