javax.swing.event
인터페이스 DocumentEvent

기존의 구현 클래스의 일람:

AbstractDocument.DefaultDocumentEvent

public interface DocumentEvent

문서 변경의 통지의 인터페이스입니다. Document 의 옵저버에, Document 가 어떻게 변경되었는지 정보를 자세하게 제공합니다. 변경의 타입, 변경 장소, 게다가 어느 Element 가 삽입 또는 삭제되었는지라고 하는 구조적인 변경의 상세 등, 고레벨의 정보를 제공합니다.

관련 항목:

Document , DocumentListener

상자의 클래스의 개요

static interface	DocumentEvent.ElementChange 특정의 요소에 대해서 더해진 변경을 기술합니다.
static class	DocumentEvent.EventType 문서 이벤트형의 열거입니다.

메소드의 개요

DocumentEvent.ElementChange	getChange (Element elem) 지정된 요소의 변경 정보를 돌려줍니다.
Document	getDocument () 변경 이벤트의 기가 된 문서를 돌려줍니다.
int	getLength () 변경의 길이를 돌려줍니다.
int	getOffset () 변경의 시점의 문서내에서의 오프셋(offset)를 돌려줍니다.
DocumentEvent.EventType	getType () 이벤트의 형태를 돌려줍니다.

메소드의 상세

getOffset

int getOffset()

변경의 시점의 문서내에서의 오프셋(offset)를 돌려줍니다.

반환값:

오프셋(offset) >= 0

getLength

int getLength()

변경의 길이를 돌려줍니다.

반환값:

길이 >= 0

getDocument

Document  getDocument()

변경 이벤트의 기가 된 문서를 돌려줍니다.

반환값:

문서

getType

DocumentEvent.EventType  getType()

이벤트의 형태를 돌려줍니다.

반환값:

타입

getChange

DocumentEvent.ElementChange  getChange(Element  elem)

지정된 요소의 변경 정보를 돌려줍니다. 변경 정보에는, 어느 요소가 추가 및 삭제되었는지, 및 그 위치가 기술되고 있습니다. 변경이 없었던 경우는, null 가 돌려주어집니다.

이 메소드는, 옵저버가 구조적인 변경을 찾아내기 위한 것입니다. 즉, 변경이 되는 전부터 존재해, 현재도 존재하고 있는 요소만이 ElementChange 의 기록을 가질 필요가 있습니다. 사용할 수 있는 변경은 재귀적인 필요는 없습니다.

예를 들어, 어느 요소가 그 부모로부터 삭제되었을 경우, 이 메소드는 부모가 변경된 것을 통지해, 부모의 변경을 기술하는 ElementChange 구현을 제공할 필요가 있습니다. 삭제된 아이에게 아이가 있는 경우에는, 이 아이 요소에 대해서는 삭제의 통지를 받을 필요는 없습니다.

아이 요소가 친요소에 삽입되었을 경우, 친요소는 변경의 통지를 할 필요가 있습니다. 아이 요소가 자신에게 삽입된 요소를 가지고 있는 경우 (부모에게 있어서는 손자에 해당한다), 이러한 요소는 변경 통지를 할 필요는 없습니다.

파라미터:

elem - 요소

반환값:

변경 정보. 요소가 변경되지 않았던 경우는 null