javax.swing.event
인터페이스 DocumentEvent

알려진 구현 클래스 목록:

AbstractDocument.DefaultDocumentEvent

public interface DocumentEvent

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

관련 항목:

Document, DocumentListener

중첩(Nested) 클래스 개요

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