HierarchyEvent (Java Platform SE 6) - xrath.com 에서 번역됨

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

JavaTM Platform
Standard Ed. 6

전의 클래스 다음의 클래스 | 프레임 있어 프레임 없음
개요: 상자 | 필드 | 생성자 | 메소드 | 상세 : 필드 | 생성자 | 메소드

## 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`
  반환값:
    이벤트를 특정하는 캐릭터 라인과 그 속성

개요 | 패키지 | 클래스 | 사용 | 계층 트리 | 비추천 API | 색인 | 헬프

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 도 참조해 주세요.