javax.swing.text.html
클래스 HTMLDocument

java.lang.Object 
  javax.swing.text.AbstractDocument 
      javax.swing.text.DefaultStyledDocument 
          javax.swing.text.html.HTMLDocument

모든 구현된 인터페이스:

Serializable, Document, StyledDocument

public class HTMLDocument
extends DefaultStyledDocument 

HTML를 모델화하는 문서입니다. 이 모델의 목적은 문서의 브라우즈와 편집의 양쪽 모두를 지원하는 것입니다. 이 때문에 HTML 문서에 의해 기술된 구조는 디폴트에서는 정확하게 복제되지 않습니다. 디폴트로 모델화 되는 요소 구조는 HTMLDocument.HTMLReader 클래스에 의해 구축됩니다. 이 클래스는 파서에 필요한 HTMLEditorKit.ParserCallback 프로토콜을 구현하고 있습니다. 구조를 변경하려면, HTMLReader 클래스를 상속해, getReader(int) 메서드를 다시 구현해 새로운 리더의 구현을 돌려주도록 합니다. 생성되는 디폴트의 구조에 대해서는 HTMLReader 메뉴얼을 참조하십시오. 디폴트의 구조는 문서의 내용이 손상되지 않는 것을 도해 구현되고 있습니다만, HTML 형식을 다시 생성할 때 다른 형식이 될 수도 있습니다.

이 문서는 HTML 만을 모델화하고 있어 뷰의 속성은 문서내에 포함되지 않습니다. 요소는 StyleContext.NameAttribute 속성에 의해 식별됩니다. 이 속성은 반드시, 요소의 종류를 식별하는 HTML.Tag 형의 값을 가지고 있습니다. 코멘트와 같이, 합성되는 요소도 있습니다. HTMLFactory는 이 속성을 사용해 구축하는 뷰의 종류를 결정합니다.

이 문서는 추가 read를 지원 하고 있습니다. TokenThreshold 프로퍼티에의해 어느 정도의 양의 해석이 버퍼에 포함된다고 문서의 요소 구조의 갱신을 실시하는지를 제어합니다. 이 프로퍼티는 EditorKit로 설정되기 때문에 서브 클래스로부터 무효로 할 수 있습니다.

Base 프로퍼티는 상대 URL를 어느 URL에 해결할까를 결정합니다. 프로퍼티의 값이 URL인 경우, 디폴트에서는 Base 프로퍼티는 Document.StreamDescriptionProperty가 됩니다. <BASE> 태그가 검출되었을 경우, 베이스는 그 태그로 지정된 URL가 됩니다. 베이스 URL는 프로퍼티이므로 직접 설정할 수 있습니다.

이 문서로 사용하는 디폴트의 컨텐츠 기억 도구는 갭 버퍼 (GapContent)입니다. 다른 도구를 지정하려면, Content 구현을 인수에 취하는 생성자를 사용합니다.

중첩(Nested) 클래스 개요

class	HTMLDocument.BlockElement HTML 구조 block를 나타내는 요소입니다.
class	HTMLDocument.HTMLReader HTML 문서를 HTML 요소 구조와 함께 로드하기 위한 HTML 리더입니다.
static class	HTMLDocument.Iterator 특정의 타입의 태그에 대해서 반복 처리를 실행하는 반복자입니다.
class	HTMLDocument.RunElement HTML 문자 레벨 속성세트를 할당할 수 있는 텍스트의 체크를 나타내는 요소입니다.

클래스 javax.swing.text. DefaultStyledDocument 로부터 상속된 중첩(Nested) 클래스/인터페이스

DefaultStyledDocument.AttributeUndoableEdit, DefaultStyledDocument.ElementBuffer, DefaultStyledDocument.ElementSpec, DefaultStyledDocument.SectionElement

클래스 javax.swing.text. AbstractDocument 로부터 상속된 중첩(Nested) 클래스/인터페이스

AbstractDocument.AbstractElement, AbstractDocument.AttributeContext, AbstractDocument.BranchElement, AbstractDocument.Content, AbstractDocument.DefaultDocumentEvent, AbstractDocument.ElementEdit, AbstractDocument.LeafElement

필드 개요

static String

AdditionalComments 문서 프로퍼티의 키의 값입니다.

클래스 javax.swing.text. DefaultStyledDocument 로부터 상속된 필드

buffer, BUFFER_SIZE_DEFAULT

클래스 javax.swing.text. AbstractDocument 로부터 상속된 필드

BAD_LOCATION, BidiElementName, ContentElementName, ElementNameAttribute, listenerList, ParagraphElementName, SectionElementName

인터페이스 javax.swing.text. Document 로부터 상속된 필드

StreamDescriptionProperty, TitleProperty

생성자 개요

HTMLDocument ()
디폴트의 버퍼 사이즈와 디폴트의 StyleSheet를 사용해 HTML 문서를 구축합니다.

HTMLDocument (AbstractDocument.Content c, StyleSheet styles)
지정된 컨텐츠 기억역의 구현과 지정된 스타일/속성 기억 도구를 사용해 HTML 문서를 작성합니다.

HTMLDocument (StyleSheet styles)
디폴트의 컨텐츠 기억역의 구현과 지정한 스타일/속성 기억역도구를 사용해 HTML 문서를 구축합니다.

메서드 개요

protected void	create (DefaultStyledDocument.ElementSpec [] data) 문서의 컨텐츠를, 지정된 요소 사양에 치환합니다.
protected Element	createBranchElement (Element parent, AttributeSet a) 다른 요소를 포함할 수 있는 문서의 가지의 요소를 작성합니다.
protected AbstractDocument.AbstractElement	createDefaultRoot () 디폴트의 문서 구조를 나타내기 위해서 사용하는 루트 요소를 작성합니다.
protected Element	createLeafElement (Element parent, AttributeSet a, int p0, int p1) 텍스트를 직접 나타내는 (자식을 가지지 않는다) 문서의 잎의 요소를 작성합니다.
protected void	fireChangedUpdate (DocumentEvent e) 이 이벤트 타입의 통지를 전달 대상으로의해 등록하고 있는 리스너 모두에게 통지합니다.
protected void	fireUndoableEditUpdate (UndoableEditEvent e) 이 이벤트 타입의 통지를 전달 대상으로의해 등록하고 있는 리스너 모두에게 통지합니다.
URL	getBase () 상대 URL를 해결 처리하는 위치를 리턴합니다.
Element	getElement (Element e, Object attribute, Object value) 속성을 가진 e 자식 요소인 value값을 포함한 attribute를 리턴합니다.
Element	getElement (String id) 지정한 id Attribute를 가지는 요소를 리턴합니다.
HTMLDocument.Iterator	getIterator (HTML.Tag t) 지정한 HTML 태그의 종류의 반복자를 취득합니다.
HTMLEditorKit.Parser	getParser () 기존의 문서에 html를 삽입할 경우에 사용하는 파서를 리턴합니다.
boolean	getPreservesUnknownTags () 미지의 태그가 발견되었을 때에 파서의 감시하는 동작을 리턴합니다.
HTMLEditorKit.ParserCallback	getReader (int pos) 파서가 HTML 문서를 로드할 때 사용하는 리더를 꺼냅니다.
HTMLEditorKit.ParserCallback	getReader (int pos, int popDepth, int pushDepth, HTML.Tag insertTag) 파서가 HTML 문서를 로드하기 위해서 사용하는 리더를 리턴합니다.
StyleSheet	getStyleSheet () HTML 문서 자체가 지정하는 문서 고유의 표시 규칙 (CSS)을 가지는 StyleSheet를 취득합니다.
int	getTokenThreshold () 문서의 요소 구조의 갱신전에 버퍼에 포함되는 토큰의 수를 취득합니다.
protected void	insert (int offset, DefaultStyledDocument.ElementSpec [] data) 새로운 요소를 일괄해 삽입합니다.
void	insertAfterEnd (Element elem, String htmlText) 지정 요소가 종료후에 캐릭터 라인으로서 지정된 HTML를 삽입합니다.
void	insertAfterStart (Element elem, String htmlText) 요소의 개시 위치에 캐릭터 라인으로서 지정된 HTML를 삽입합니다.
void	insertBeforeEnd (Element elem, String htmlText) 요소의 종료 위치에 캐릭터 라인으로서 지정된 HTML를 삽입합니다.
void	insertBeforeStart (Element elem, String htmlText) 지정된 요소가 개시되기 전에 캐릭터 라인으로서 지정된 HTML를 삽입합니다.
protected void	insertUpdate (AbstractDocument.DefaultDocumentEvent chng, AttributeSet attr) 텍스트의 삽입에 응해 문서를 갱신합니다.
void	processHTMLFrameHyperlinkEvent (HTMLFrameHyperlinkEvent e) HTML 프레임내에서 문서에 의해 생성된 HyperlinkEvents 처리를 합니다.
void	setBase (URL u) 상대 URL를 해결 처리하는 위치를 설정합니다.
void	setInnerHTML (Element elem, String htmlText) 지정된 요소의 자식을 HTML 캐릭터 라인으로서 지정된 컨텐츠와 옮겨놓습니다.
void	setOuterHTML (Element elem, String htmlText) 지정된 부모의 요소를 HTML 캐릭터 라인으로서 지정된 컨텐츠와 옮겨놓습니다.
void	setParagraphAttributes (int offset, int length, AttributeSet s, boolean replace) 단락에 속성을 설정합니다.
void	setParser (HTMLEditorKit.Parser parser) 기존의 문서에 setInnerHTML 나 setOuterHTML 등의 html를 삽입할 경우에 메서드가 사용하는 파서를 설정합니다.
void	setPreservesUnknownTags (boolean preservesTags) 파서에 의해 미지의 태그를 처리하는 방법을 판정합니다.
void	setTokenThreshold (int n) 문서의 요소 구조의 갱신전에 버퍼에 포함되는 토큰의 수를 설정합니다.

클래스 javax.swing.text. DefaultStyledDocument 로부터 상속된 메서드

addDocumentListener, addStyle, getBackground, getCharacterElement, getDefaultRootElement, getFont, getForeground, getLogicalStyle, getParagraphElement, getStyle, getStyleNames, removeDocumentListener, removeStyle, removeUpdate, setCharacterAttributes, setLogicalStyle, styleChanged

클래스 javax.swing.text. AbstractDocument 로부터 상속된 메서드

addUndoableEditListener, createPosition, dump, fireInsertUpdate, fireRemoveUpdate, getAsynchronousLoadPriority, getAttributeContext, getBidiRootElement, getContent, getCurrentWriter, getDocumentFilter, getDocumentListeners, getDocumentProperties, getEndPosition, getLength, getListeners, getProperty, getRootElements, getStartPosition, getText, getText, getUndoableEditListeners, insertString, postRemoveUpdate, putProperty, readLock, readUnlock, remove, removeUndoableEditListener, render, replace, setAsynchronousLoadPriority, setDocumentFilter, setDocumentProperties, writeLock, writeUnlock

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

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

인터페이스 javax.swing.text. Document 로부터 상속된 메서드

addUndoableEditListener, createPosition, getEndPosition, getLength, getProperty, getRootElements, getStartPosition, getText, getText, insertString, putProperty, remove, removeUndoableEditListener, render

필드의 상세

AdditionalComments

public static final String  AdditionalComments

문서 프로퍼티의 키의 값입니다. 키에 대응하는 값은 String Vector가 됩니다. 이 캐릭터 라인은 본문에는 없는 코멘트입니다.

관련 항목:

정수 필드값

생성자 상세

HTMLDocument

public HTMLDocument()

디폴트의 버퍼 사이즈와 디폴트의 StyleSheet를 사용해 HTML 문서를 구축합니다. 이것은 생성자 HTMLDocument(Content, StyleSheet) 간이 메서드입니다.

HTMLDocument

public HTMLDocument(StyleSheet  styles)

디폴트의 컨텐츠 기억역의 구현과 지정한 스타일/속성 기억역도구를 사용해 HTML 문서를 구축합니다. 이것은 생성자 HTMLDocument(Content, StyleSheet) 간이 메서드입니다.

파라미터:

styles - 스타일

HTMLDocument

public HTMLDocument(AbstractDocument.Content  c,
                    StyleSheet  styles)

지정된 컨텐츠 기억역의 구현과 지정된 스타일/속성 기억 도구를 사용해 HTML 문서를 작성합니다.

파라미터:

c - 컨텐츠의 컨테이너

styles - 스타일

메서드의 상세

getReader

public HTMLEditorKit.ParserCallback  getReader(int pos)

파서가 HTML 문서를 로드할 때 사용하는 리더를 꺼냅니다. 이 메서드는 HTMLDocument.HTMLReader 인스턴스를 돌려주기 위해서 구현됩니다. 서브 클래스는 필요하면, 커스텀 태그나 문자 스타일 요소의 구조적 표현의 처리등을 때문에에 이 메서드를 재구현해 문서의 구조화 수단을 변경할 수 있습니다.

파라미터:

pos - 개시 위치

반환값:

파서가 문서를 로드하기 위해서 사용하는 리더

getReader

public HTMLEditorKit.ParserCallback  getReader(int pos,
                                              int popDepth,
                                              int pushDepth,
                                              HTML.Tag  insertTag)

파서가 HTML 문서를 로드하기 위해서 사용하는 리더를 리턴합니다. 이 메서드는 HTMLDocument.HTMLReader 인스턴스를 돌려주기 위해서 구현됩니다. 서브 클래스는 필요하면, 커스텀 태그나 문자 스타일 요소의 구조적 표현의 처리등을 때문에에 이 메서드를 재구현해 문서의 구조화 수단을 변경할 수 있습니다.

이것은, getReader(int, int, int, HTML.Tag, TRUE) 간이 메서드입니다.

파라미터:

popDepth - 삽입전에 생성되는 ElementSpec.EndTagTypes 태그의 수

pushDepth - 종료 태그의 생성 후, 삽입전에 생성되는 ElementSpec.JoinNextDirection 방향을 가지는 ElementSpec.StartTagTypes 태그의 수

insertTag - 문서에의 삽입을 개시하는 최초의 태그

반환값:

파서가 문서를 로드하기 위해서 사용하는 리더

getBase

public URL  getBase()

상대 URL를 해결 처리하는 위치를 리턴합니다. 디폴트에서는 이 정도치는 문서가 URL 로부터 로드 되었을 경우에는 문서의 URL가 됩니다. 베이스 태그가 발견되어, 해석할 수 있는 경우에는 그것을 베이스 위값으로 사용합니다.

반환값:

베이스 위치

setBase

public void setBase(URL  u)

상대 URL를 해결 처리하는 위치를 설정합니다. 디폴트에서는 이 정도치는 문서가 URL 로부터 로드 되었을 경우에는 문서의 URL가 됩니다. 베이스 태그가 발견되어, 해석할 수 있는 경우에는 그것을 베이스 위값으로 사용합니다.

StyleSheet 베이스를 u와 문서의 베이스로 설정합니다.

파라미터:

u - 해당하는 베이스 URL

insert

protected void insert(int offset,
                      DefaultStyledDocument.ElementSpec [] data)
               throws BadLocationException 

새로운 요소를 일괄해 삽입합니다. 요소는 이와 같이의해 문서내에 작성됩니다. 해석에 의해 어떠한 구조가 필요한가를 결정해 문서에 출력락이 걸리지 않은 동안에 편집을 기술하는 토큰세트로서 사양을 작성합니다. 이 메서드는 리더에 의해 정리해 불려가, 단시간의 사이 출력 락을 얻습니다. 문서에의 실제의 출력은 이 시간에 행해집니다.

오버라이드(override):

클래스 DefaultStyledDocument 내의 insert

파라미터:

offset - 개시 오프셋(offset)

data - 요소 데이터

예외:

BadLocationException - 지정된 위값이 관련된 문서내의 유효한 위치를 나타내지 않는 경우

insertUpdate

protected void insertUpdate(AbstractDocument.DefaultDocumentEvent  chng,
                            AttributeSet  attr)

텍스트의 삽입에 응해 문서를 갱신합니다. 이 액션은 출력락 안에서 발생합니다. 이 구현은 삽입된 컨텐츠를 단지 개행 마다 구문 분석 해, 요소 버퍼에 대한 일련의 지시를 구축합니다.

오버라이드(override):

클래스 DefaultStyledDocument 내의 insertUpdate

파라미터:

chng - 문서 변경의 설명

attr - 속성

create

protected void create(DefaultStyledDocument.ElementSpec [] data)

문서의 컨텐츠를, 지정된 요소 사양에 치환합니다. 이 메서드는 로드가 정리해 완료했을 경우, 삽입전에 호출합니다. 문서 전체를 한 번에 정리해 로드하는 경우에 호출되는 유일한 메서드입니다.

오버라이드(override):

클래스 DefaultStyledDocument 내의 create

파라미터:

data - 문서의 새로운 컨텐츠

setParagraphAttributes

public void setParagraphAttributes(int offset,
                                   int length,
                                   AttributeSet  s,
                                   boolean replace)

단락에 속성을 설정합니다.

이 메서드는 thread에 대해서 안전합니다만, 대부분의 Swing 메서드는 다릅니다. 자세한 내용은 「Threads and Swing」를 참조하십시오.

정의:

인터페이스 StyledDocument 내의 setParagraphAttributes

오버라이드(override):

클래스 DefaultStyledDocument 내의 setParagraphAttributes

파라미터:

offset - 단락에 대한 오프셋(offset) (최소에서도 0 이 아니면 안된다)

length - 영향을 받는 문자수 (최소에서도 0 이 아니면 안된다)

s - 속성

replace - 기존의 속성을 치환하는지, 머지 할까

getStyleSheet

public StyleSheet  getStyleSheet()

HTML 문서 자체가 지정하는 문서 고유의 표시 규칙 (CSS)을 가지는 StyleSheet를 취득합니다.

반환값:

StyleSheet

getIterator

public HTMLDocument.Iterator  getIterator(HTML.Tag  t)

지정한 HTML 태그의 종류의 반복자를 취득합니다. 포함 되고 있는 엥커세트에서의 반복 처리나, 입력 요소에서의 반복 처리등으로 사용됩니다.

파라미터:

t - 요구한 HTML.Tag

반환값:

지정한 HTML 태그의 Iterator

관련 항목:

HTML.Tag

createLeafElement

protected Element  createLeafElement(Element  parent,
                                    AttributeSet  a,
                                    int p0,
                                    int p1)

텍스트를 직접 나타내는 (자식을 가지지 않는다) 문서의 잎의 요소를 작성합니다. HTMLDocument.RunElement 형의 요소를 돌려주기 위해서 구현됩니다.

오버라이드(override):

클래스 AbstractDocument 내의 createLeafElement

파라미터:

parent - 친요소

a - 요소의 속성

p0 - 범위의 시점 (최소에서도 0 이 아니면 안된다)

p1 - 범위의 종점 (최소에서도 p0가 아니면 안된다)

반환값:

새로운 요소

createBranchElement

protected Element  createBranchElement(Element  parent,
                                      AttributeSet  a)

다른 요소를 포함할 수 있는 문서의 가지의 요소를 작성합니다. HTMLDocument.BlockElement 형의 요소를 돌려주기 위해서 구현됩니다.

오버라이드(override):

클래스 AbstractDocument 내의 createBranchElement

파라미터:

parent - 친요소

a - 속성

반환값:

요소

createDefaultRoot

protected AbstractDocument.AbstractElement  createDefaultRoot()

디폴트의 문서 구조를 나타내기 위해서 사용하는 루트 요소를 작성합니다.

오버라이드(override):

클래스 DefaultStyledDocument 내의 createDefaultRoot

반환값:

요소 베이스

setTokenThreshold

public void setTokenThreshold(int n)

문서의 요소 구조의 갱신전에 버퍼에 포함되는 토큰의 수를 설정합니다.

파라미터:

n - 버퍼 되는 토큰의 수

getTokenThreshold

public int getTokenThreshold()

문서의 요소 구조의 갱신전에 버퍼에 포함되는 토큰의 수를 취득합니다. 기본값는 Integer.MAX_VALUE 입니다.

반환값:

버퍼 되는 토큰의 수

setPreservesUnknownTags

public void setPreservesUnknownTags(boolean preservesTags)

파서에 의해 미지의 태그를 처리하는 방법을 판정합니다. true를 설정하면 미지의 태그는 모델에 넣어져 그렇지 않은 경우는 모델로부터 제외됩니다.

파라미터:

preservesTags - 미지의 태그가 모델에 보존되는 경우는 true, 그렇지 않은 경우, 태그는 모델로부터 제외되는

관련 항목:

HTML.Tag

getPreservesUnknownTags

public boolean getPreservesUnknownTags()

미지의 태그가 발견되었을 때에 파서의 감시하는 동작을 리턴합니다.

반환값:

해석시에 미지의 태그가 남겨지는 경우는 true

관련 항목:

HTML.Tag

processHTMLFrameHyperlinkEvent

public void processHTMLFrameHyperlinkEvent(HTMLFrameHyperlinkEvent  e)

HTML 프레임내에서 문서에 의해 생성된 HyperlinkEvents 처리를 합니다. HyperlinkEvents 타입은 파라미터가 나타내는 대로HTMLFrameHyperlinkEvent 입니다. HyperlinkEvents에 포함되는 보통 의 정보 외에 이 이벤트는 클릭이 발생한 프레임 (발생원의 요소)에 대응하는 요소 및 타겟명을 포함하고 있습니다. 타겟명은 다음에 나타내는 4 종류의 값의 어떤 것인가입니다.

• _self
• _parent
• _top
• 이름이 붙은 프레임

타겟이 _self인 경우, HTML.Attribute.SRC값을 변경하는 액션이 발생해, ChangedUpdate 이벤트를 트리거 합니다.

타겟이 _parent인 경우, <FRAMESET> 요소인 친요소를 삭제해, 새로운 <FRAME> 요소를 삽입한 뒤, HTML.Attribute.SRC 속성이 송신지의 URL와 동일한 값을 가지도록 설정해 RemovedUpdate 및 InsertUpdate를 트리거 합니다.

타겟이 _top인 경우, 이 메서드는 아무것도 처리를 실시하지 않습니다. _top는 프레임용의 뷰의 구현 (구체적으로는 FrameView)으로 처리됩니다. _top는 문서 전체의 치환을 미하기 위해, 치환 대상 문서의 외부에서 처리해 주세요.

타겟이 프레임명의 경우, 타겟과 같은 이름의 요소를 요소 계층으로부터 찾아, 그 요소의 HTML.Attribute.SRC 속성을 갱신해 ChangedUpdate 이벤트를 트리거 합니다.

파라미터:

e - 이벤트

setParser

public void setParser(HTMLEditorKit.Parser  parser)

기존의 문서에 setInnerHTML 나 setOuterHTML 등의 html를 삽입할 경우에 메서드가 사용하는 파서를 설정합니다.

HTMLEditorKit.createDefaultDocument는 파서를 설정합니다. 수동으로 HTMLDocument 문서를 작성하는 경우는 각각 대응한 파서를 설정하도록의해 주세요.

파라미터:

parser - 텍스트의 삽입에 사용되는 파서

도입된 버전 :

1.3

getParser

public HTMLEditorKit.Parser  getParser()

기존의 문서에 html를 삽입할 경우에 사용하는 파서를 리턴합니다.

반환값:

텍스트의 삽입에 사용되는 파서

도입된 버전 :

1.3

setInnerHTML

public void setInnerHTML(Element  elem,
                         String  htmlText)
                  throws BadLocationException,

                         IOException 

지정된 요소의 자식을 HTML 캐릭터 라인으로서 지정된 컨텐츠와 옮겨놓습니다.

2개 이상의 이벤트로서 표시되어 삭제에 계속되어 n를 삽입합니다.

올바르게 기능시키기 위해서 문서는 HTMLEditorKit.Parser를 준비할 필요가 있습니다. 이것은 문서가 HTMLEditorKit 로부터 createDefaultDocument 메서드에 의해 생성되었을 경우입니다.

파라미터:

elem - 자가 옮겨놓을 수 있는 가지의 요소

htmlText - 해석되어elem에 할당할 수 있는 캐릭터 라인

예외:

IllegalArgumentException - elem가 잎의 경우

IllegalStateException - HTMLEditorKit.Parser가 미정도리의 경우

BadLocationException

IOException

도입된 버전 :

1.3

setOuterHTML

public void setOuterHTML(Element  elem,
                         String  htmlText)
                  throws BadLocationException,

                         IOException 

지정된 부모의 요소를 HTML 캐릭터 라인으로서 지정된 컨텐츠와 옮겨놓습니다.

2개 이상의 이벤트로서 표시되어 삭제에 계속되어 n를 삽입합니다.

잎을 바꿀 때는 개행이 필요한 경우에 개행이 있을지 어떨지를 확인해 주세요. 이것으로 추가 요소가 삽입됩니다. <img>를 가지는 개행을 포함한 문자 요소를 옮겨놓으려고 하는 경우는 1개는 이미지용, 하나 더는 개행용으로 2개의 요소를 생성하게 됩니다.

요소의 길이를 옮겨놓으면, 2개의 요소로 종료합니다. 즉, setOuterHTML(getCharacterElement(getLength()), "blah")가 최종적으로 2개의 잎요소가 됩니다. 1개는 blah를 나타내, 이제(이미 ) 1개는 말미 요소를 나타냅니다.

올바르게 기능시키기 위해서 문서는 HTMLEditorKit.Parser를 준비할 필요가 있습니다. 이것은 문서가 HTMLEditorKit 로부터 createDefaultDocument 메서드에 의해 생성되었을 경우입니다.

파라미터:

elem - 자가 옮겨놓을 수 있는 가지의 요소

htmlText - 해석되어elem에 할당할 수 있는 캐릭터 라인

예외:

IllegalStateException - HTMLEditorKit.Parser가 미설정의 경우

BadLocationException

IOException

도입된 버전 :

1.3

insertAfterStart

public void insertAfterStart(Element  elem,
                             String  htmlText)
                      throws BadLocationException,

                             IOException 

요소의 개시 위치에 캐릭터 라인으로서 지정된 HTML를 삽입합니다.

올바르게 기능시키기 위해서 문서는 HTMLEditorKit.Parser를 준비할 필요가 있습니다. 이것은 문서가 HTMLEditorKit 로부터 createDefaultDocument 메서드에 의해 생성되었을 경우입니다.

파라미터:

elem - 새로운 텍스트의 루트인 가지의 요소

htmlText - 해석되어elem에 할당할 수 있는 캐릭터 라인

예외:

IllegalStateException - HTMLEditorKit.Parser가 문서로 설정되어 있지 않은 경우

BadLocationException

IOException

도입된 버전 :

1.3

insertBeforeEnd

public void insertBeforeEnd(Element  elem,
                            String  htmlText)
                     throws BadLocationException,

                            IOException 

요소의 종료 위치에 캐릭터 라인으로서 지정된 HTML를 삽입합니다.

elem 자식이 잎으로elem.getEndOffset() - 1 문자가 개행인 경우, 개행 후에 텍스트가 없게 하기 위해서 개행전에 삽입합니다.

올바르게 기능시키기 위해서 문서는 HTMLEditorKit.Parser를 준비할 필요가 있습니다. 이것은 문서가 HTMLEditorKit 로부터 createDefaultDocument 메서드에 의해 생성되었을 경우입니다.

파라미터:

elem - 새로운 텍스트의 루트인 요소

htmlText - 해석되어elem에 할당할 수 있는 캐릭터 라인

예외:

IllegalStateException - HTMLEditorKit.Parser가 문서로 설정되어 있지 않은 경우

BadLocationException

IOException

도입된 버전 :

1.3

insertBeforeStart

public void insertBeforeStart(Element  elem,
                              String  htmlText)
                       throws BadLocationException,

                              IOException 

지정된 요소가 개시되기 전에 캐릭터 라인으로서 지정된 HTML를 삽입합니다.

올바르게 기능시키기 위해서 문서는 HTMLEditorKit.Parser를 준비할 필요가 있습니다. 이것은 문서가 HTMLEditorKit 로부터 createDefaultDocument 메서드에 의해 생성되었을 경우입니다.

파라미터:

elem - 새로운 텍스트의 루트인 요소

htmlText - 해석되어elem에 할당할 수 있는 캐릭터 라인

예외:

IllegalStateException - HTMLEditorKit.Parser가 문서로 설정되어 있지 않은 경우

BadLocationException

IOException

도입된 버전 :

1.3

insertAfterEnd

public void insertAfterEnd(Element  elem,
                           String  htmlText)
                    throws BadLocationException,

                           IOException 

지정 요소가 종료후에 캐릭터 라인으로서 지정된 HTML를 삽입합니다.

올바르게 기능시키기 위해서 문서는 HTMLEditorKit.Parser를 준비할 필요가 있습니다. 이것은 문서가 HTMLEditorKit 로부터 createDefaultDocument 메서드에 의해 생성되었을 경우입니다.

파라미터:

elem - 새로운 텍스트의 루트인 요소

htmlText - 해석되어elem에 할당할 수 있는 캐릭터 라인

예외:

IllegalStateException - HTMLEditorKit.Parser가 문서로 설정되어 있지 않은 경우

BadLocationException

IOException

도입된 버전 :

1.3

getElement

public Element  getElement(String  id)

지정한 id Attribute를 가지는 요소를 리턴합니다. 요소가 발견되지 않는 경우는 null이 리턴됩니다 . 이 메서드는 Attribute에 대해서 일해, 문자 태그에 대해서는 일하지 않습니다. HTML 간단한 예 <a id="HelloThere">에 대해, 속성은 id, 문자 태그는 a 입니다. 이 메서드는 getElement(RootElement, HTML.Attribute.id, id) 간이 메서드입니다. 이것은 thread에 대해서 안전하지는 않습니다.

파라미터:

id - 목적의 Attribute 캐릭터 라인 표현

반환값:

지정한 Attribute를 가지는 요소. 발견되지 않는 경우나 id가 null인 경우는 null

도입된 버전 :

1.3

관련 항목:

HTML.Attribute

getElement

public Element  getElement(Element  e,
                          Object  attribute,
                          Object  value)

속성을 가진 e 자식 요소인 value값을 포함한 attribute를 리턴합니다. 발견되지 않는 경우는 null. 이 메서드는 thread에 대해서 안전하지는 않습니다.

파라미터:

e - 검색을 개시하는 루트 요소

attribute - 목적의 Attribute

value - 지정한 Attribute값

반환값:

지정한 Attribute와 지정한 value를 가지는 요소. 발견되지 않는 경우는 null

도입된 버전 :

1.3

관련 항목:

HTML.Attribute

fireChangedUpdate

protected void fireChangedUpdate(DocumentEvent  e)

이 이벤트 타입의 통지를 전달 대상으로의해 등록하고 있는 리스너 모두에게 통지합니다. fire 메서드에게 건네진 파라미터를 사용해, 이벤트의 인스턴스는 생성됩니다.

오버라이드(override):

클래스 AbstractDocument 내의 fireChangedUpdate

파라미터:

e - 이벤트

관련 항목:

EventListenerList

fireUndoableEditUpdate

protected void fireUndoableEditUpdate(UndoableEditEvent  e)

이 이벤트 타입의 통지를 전달 대상으로의해 등록하고 있는 리스너 모두에게 통지합니다. fire 메서드에게 건네진 파라미터를 사용해, 이벤트의 인스턴스는 생성됩니다.

오버라이드(override):

클래스 AbstractDocument 내의 fireUndoableEditUpdate

파라미터:

e - 이벤트

관련 항목:

EventListenerList