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 객체, 또는 null (객체가 Component이 아닌 경우)

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

반환값:

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