javax.swing.text
인터페이스 Element

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

AbstractDocument.AbstractElement , AbstractDocument.BranchElement , AbstractDocument.LeafElement , DefaultStyledDocument.SectionElement , HTMLDocument.BlockElement , HTMLDocument.RunElement

public interface Element

문서의 구조상의 부품을 기술하는 인터페이스입니다. 이것은, SGML 요소의 특성을 거두어 들이는 것을 목적으로 하고 있습니다.

메소드의 개요

AttributeSet	getAttributes () 이 요소가 보관 유지하는 속성의 컬렉션을 가져옵니다.
Document	getDocument () 이 요소에 관련한 문서를 가져옵니다.
Element	getElement (int index) 지정된 인덱스의 아이 요소를 가져옵니다.
int	getElementCount () 이 요소가 포함한 아이 요소의 수를 돌려줍니다.
int	getElementIndex (int offset) 지정 오프셋(offset)에 가장 가까운 아이 요소의 인덱스를 가져옵니다.
int	getEndOffset () 이 요소가 끝나는, 문서의 선두로부터의 오프셋(offset)를 가져옵니다.
String	getName () 요소명을 가져옵니다.
Element	getParentElement () 친요소를 가져옵니다.
int	getStartOffset () 이 요소가 시작되는, 문서의 선두로부터의 오프셋(offset)를 가져옵니다.
boolean	isLeaf () 이 요소가 잎요소인가 어떤가를 판정합니다.

메소드의 상세

getDocument

Document  getDocument()

이 요소에 관련한 문서를 가져옵니다.

반환값:

문서

getParentElement

Element  getParentElement()

친요소를 가져옵니다. 루트 레벨의 요소인 경우는,null 를 돌려줍니다.

반환값:

친요소

getName

String  getName()

요소명을 가져옵니다. 요소를 사용해 구조의 특정의 타입을 나타내는 경우, 이것은 타입명이 됩니다.

반환값:

요소의 이름

getAttributes

AttributeSet  getAttributes()

이 요소가 보관 유지하는 속성의 컬렉션을 가져옵니다.

반환값:

요소의 속성

getStartOffset

int getStartOffset()

이 요소가 시작되는, 문서의 선두로부터의 오프셋(offset)를 가져옵니다. 이 요소가 아이 요소를 가지고 있는 경우, 이것은 최초의 아이의 오프셋(offset)가 됩니다. 문서의 위치로서는, 암묵의 전송 바이어스가 있습니다.

반환값:

개시 오프셋(offset). 0 이상으로 getEndOffset()보다 작은

관련 항목:

Document , AbstractDocument

getEndOffset

int getEndOffset()

이 요소가 끝나는, 문서의 선두로부터의 오프셋(offset)를 가져옵니다. 이 요소가 아이 요소를 가지고 있는 경우, 이것은 마지막 아이의 종료 오프셋(offset)가 됩니다. 문서의 위치로서는, 암묵의 역전송바이어스가 있습니다.

모든 디폴트 Document 구현은 AbstractDocument 로부터 파생합니다. AbstractDocument 는 문서의 마지막에 암묵의 브레이크를 형성합니다. 그 결과, 문서의 길이보다 긴 값을 돌려줄 수도 있습니다.

반환값:

종료 오프셋(offset). getStartOffset()보다 크고 getDocument(). getLength() + 1 이하

관련 항목:

Document , AbstractDocument

getElementIndex

int getElementIndex(int offset)

지정 오프셋(offset)에 가장 가까운 아이 요소의 인덱스를 가져옵니다. 오프셋(offset)는 문서의 선두와의 상대 위치에서 지정됩니다. Element 가 잎의 경우는 -1 이 돌려주어져 그렇지 않은 경우는 지정한 위치를 가장 자주(잘) 나타내는 Element 의 인덱스가 돌려주어집니다. 위치가 개시 오프셋(offset)보다 작은 경우는,0 이 돌려주어집니다. 또, 위치가 종료 오프셋(offset) 이상의 경우는,getElementCount() - 1 이 돌려주어집니다.

파라미터:

offset - 지정 오프셋(offset) >= 0

반환값:

요소의 인덱스 >= 0

getElementCount

int getElementCount()

이 요소가 포함한 아이 요소의 수를 돌려줍니다. 이 요소가 잎요소의 경우, 제로가 돌려주어집니다.

반환값:

자 요소의 수 >= 0

getElement

Element  getElement(int index)

지정된 인덱스의 아이 요소를 가져옵니다.

파라미터:

index - 지정한 인덱스 >= 0

반환값:

자 요소

isLeaf

boolean isLeaf()

이 요소가 잎요소인가 어떤가를 판정합니다. 아이를 가질 가능성이 있는 요소는, 비록 그 시점에서 아이를 가지고 있지 않아도,false 를 돌려줍니다.

반환값:

잎요소의 경우는 true, 그렇지 않은 경우는 false