java.beans
클래스 PropertyChangeEvent

java.lang.Object 
  java.util.EventObject 
      java.beans.PropertyChangeEvent

모든 구현된 인터페이스:

Serializable

직계의 기존의 서브 클래스:

IndexedPropertyChangeEvent

public class PropertyChangeEvent
extends EventObject 

PropertyChange 이벤트는, Bean 가 「바운드」프로퍼티 또는 「제약」프로퍼티을 변경할 때마다 송신됩니다. PropertyChangeEvent 객체는, 인수로서 PropertyChangeListener 와 VetoableChangeListener 메소드에 송신됩니다.

일반적으로, PropertyChangeEvents 는, 변경된 프로퍼티의 이름이라고 변경 전후의 값과 함께 사용됩니다. 새로운 값이 원시형 (int 나 boolean 등)인 경우, 대응하는 java.lang. * Object 형 (Integer 나 Boolean 등)으로서 랩 될 필요가 있습니다.

변경 전후의 실제의 값이 불명한 경우는, null 치가 사용되는 일이 있습니다.

이벤트 소스가 null 객체를 이름으로서 송신해, 그 프로퍼티의 임의세트가 변경된 것을 나타내는 경우가 있습니다. 이 경우는, 변경전이라고 변경 후의 값도 null 가 될 것입니다.

관련 항목:

직렬화 된 형식

필드의 개요

클래스 java.util. EventObject 로부터 상속된 필드

source

생성자 의 개요

PropertyChangeEvent (Object source, String propertyName, Object oldValue, Object newValue)
새로운 PropertyChangeEvent 를 구축합니다.

메소드의 개요

Object	getNewValue () 프로퍼티의 변경 후의 값 (Object 로 나타내진다)을 가져옵니다.
Object	getOldValue () 프로퍼티의 변경전의 값 (Object 로 나타내진다)을 가져옵니다.
Object	getPropagationId () propagationId 필드는, 향후 사용하기 위해서 예약되고 있습니다.
String	getPropertyName () 변경된 프로퍼티의 프로그램명을 가져옵니다.
void	setPropagationId (Object propagationId) 이벤트의 propagationId 객체를 설정합니다.

클래스 java.util. EventObject 로부터 상속된 메소드

getSource , toString

클래스 java.lang. Object 로부터 상속된 메소드

clone , equals , finalize , getClass , hashCode , notify , notifyAll , wait , wait , wait

생성자 의 상세

PropertyChangeEvent

public PropertyChangeEvent(Object  source,
                           String  propertyName,
                           Object  oldValue,
                           Object  newValue)

새로운 PropertyChangeEvent 를 구축합니다.

파라미터:

source - 이벤트를 트리거한 Bean

propertyName - 변경된 프로퍼티의 프로그램명

oldValue - 프로퍼티의 낡은 값

newValue - 프로퍼티의 새로운 값

메소드의 상세

getPropertyName

public String  getPropertyName()

변경된 프로퍼티의 프로그램명을 가져옵니다.

반환값:

변경된 프로퍼티의 프로그램명. 복수의 프로퍼티이 변경되었을 경우는 null

getNewValue

public Object  getNewValue()

프로퍼티의 변경 후의 값 (Object 로 나타내진다)을 가져옵니다.

반환값:

프로퍼티의 변경 후의 값 (Object 로 나타내진다). 복수의 프로퍼티이 변경되었을 경우는 null

getOldValue

public Object  getOldValue()

프로퍼티의 변경전의 값 (Object 로 나타내진다)을 가져옵니다.

반환값:

프로퍼티의 변경전의 값 (Object 로 나타내진다). 복수의 프로퍼티이 변경되었을 경우는 null

setPropagationId

public void setPropagationId(Object  propagationId)

이벤트의 propagationId 객체를 설정합니다.

파라미터:

propagationId - 이벤트의 propagationId 객체

getPropagationId

public Object  getPropagationId()

propagationId 필드는, 향후 사용하기 위해서 예약되고 있습니다. Beans 1.0 에서는, 청취자가 PropertyChangeEvent 를 캐치 하고 나서 자신의 PropertyChangeEvent 를 트리거하는 경우는, propagationId 필드를 수신 이벤트로부터 송신 이벤트에 확실히 전달하는 것이 유일한 요건이 됩니다.

반환값:

바운드 프로퍼티 또는 제약 프로퍼티의 갱신에 관련한 propagationId 객체