javax.swing.text.html
클래스 HTMLDocument

java.lang.Object 
  |
  +--javax.swing.text.AbstractDocument 
        |
        +--javax.swing.text.DefaultStyledDocument 
              |
              +--javax.swing.text.html.HTMLDocument

모든 구현 인터페이스:

Document , Serializable , 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 의 구현을 인수에 취하는 constructor　 　 을 사용합니다.

중첩된 클래스의 개요

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

클래스 javax.swing.text. DefaultStyledDocument 을 상속받은 중첩된 클래스

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

클래스 javax.swing.text. AbstractDocument 을 상속받은 중첩된 클래스

AbstractDocument.AttributeContext , AbstractDocument.Content , AbstractDocument.DefaultDocumentEvent , AbstractDocument.ElementEdit

필드의 개요

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

constructor 의 개요

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 가 됩니다. 이 캐릭터 라인은, 본문은 없는 코멘트입니다.

관련 항목:

정수 필드치

constructor 의 상세

HTMLDocument

public HTMLDocument()

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

HTMLDocument

public HTMLDocument(StyleSheet  styles)

디폴트의 컨텐츠 기억역의 구현과 지정한 스타일/속성 기억역기구를 사용해 HTML 문서를 구축합니다. 이것은, constructor　 　 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 를 나타내, 하나 더는 말미 요소를 나타냅니다.

올바르게 기능시키기 위해서(때문에), 문서는 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