javax.swing.text
클래스 DefaultStyledDocument

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

모든 구현된 인터페이스:

Serializable, Document, StyledDocument

알려진 직계 서브 클래스:

HTMLDocument

public class DefaultStyledDocument
extends AbstractDocument 
implements StyledDocument 

RTF (Rich Text Format)에 유사한 방식을 사용해, 자체나 단락 서식을 마크 올라갈 수 있는 문서입니다. 이 문서의 요소 구조는 스타일 런의 스타일의 편성을 나타냅니다. 이러한 스타일 런은 단락 요소의 구조 (다른 구조에 포함되고 있는 경우도 있어)에 대응 붙일 수 있습니다. 논리 서식이 단락 경계로 지정되고 있으므로 스타일 런은 단락 경계에서 분할됩니다.

경고: 이 클래스의 직렬화 된 객체는 향후의 Swing 릴리즈와 호환되지 않을 예정입니다. 현재의 직렬화의 지원은 단기간의 운용이나, 같은 버전의 Swing를 실행하는 어플리케이션간의 RMI에 적절하고 있습니다. JDK 버전 1.4 이후, 모든 JavaBeans^™ 장기간의 운용 지원은 java.beans 패키지에 추가되고 있습니다. 자세한 내용은 XMLEncoder를 참조하십시오.

관련 항목:

Document, AbstractDocument

중첩(Nested) 클래스 개요

static class	DefaultStyledDocument.AttributeUndoableEdit UndoableEdit는 Element AttributeSet에 더해진 변경을 기억하기 위해서 사용합니다.
class	DefaultStyledDocument.ElementBuffer 요소의 계층에 대한 변경을 관리하는 클래스입니다.
static class	DefaultStyledDocument.ElementSpec 요소를 구축하는 구현입니다.
protected class	DefaultStyledDocument.SectionElement 문서의 디폴트 루트 요소로 포함되는 단락이나 행을 매핑 합니다.

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

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

필드 개요

protected DefaultStyledDocument.ElementBuffer	buffer
static int	BUFFER_SIZE_DEFAULT 초기 컨텐츠 버퍼의 디폴트 사이즈입니다.

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

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

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

StreamDescriptionProperty, TitleProperty

생성자 개요

DefaultStyledDocument ()
디폴트의 서식 첨부 문서를 구축합니다.

DefaultStyledDocument (AbstractDocument.Content c, StyleContext styles)
서식 첨부 문서를 구축합니다.

DefaultStyledDocument (StyleContext styles)
디폴트의 컨텐츠 기억역의 구현과 서식의 공유 세트를 사용해, 서식 첨부 문서를 구축합니다.

메서드 개요

void	addDocumentListener (DocumentListener listener) 문서 리스너를 추가해, 변경이 있었을 때에 통지되도록 합니다.
Style	addStyle (String nm, Style parent) 논리 서식 계층에 새로운 서식을 추가합니다.
protected void	create (DefaultStyledDocument.ElementSpec [] data) 문서를 초기화해, 지정된 요소 구조 (getDefaultRootElement 메서드에 의해 보고되는 구조)를 반영합니다.
protected AbstractDocument.AbstractElement	createDefaultRoot () 디폴트의 문서 구조를 나타내기 위해서 사용하는 루트 요소를 작성합니다.
Color	getBackground (AttributeSet attr) 속성 세트로부터 백그라운드 컬러를 리턴합니다.
Element	getCharacterElement (int pos) 위치에 근거해 문자 요소를 리턴합니다.
Element	getDefaultRootElement () 디폴트의 루트 요소를 리턴합니다.
Font	getFont (AttributeSet attr) 속성 세트로부터 폰트를 리턴합니다.
Color	getForeground (AttributeSet attr) 속성 세트로부터 foreground 컬러를 리턴합니다.
Style	getLogicalStyle (int p) 지정된 위치에 의해 나타내진 단락에 할당할 수 있었던 논리 서식을 꺼냅니다.
Element	getParagraphElement (int pos) 오프셋(offset) pos 단락의 요소를 리턴합니다.
Style	getStyle (String nm) 이전에 추가된 이름 첨부 서식을 꺼냅니다.
Enumeration <? >	getStyleNames () 서식명의 리스트를 꺼냅니다.
protected void	insert (int offset, DefaultStyledDocument.ElementSpec [] data) 새로운 요소를 일괄해 삽입합니다.
protected void	insertUpdate (AbstractDocument.DefaultDocumentEvent chng, AttributeSet attr) 텍스트의 삽입에 응해 문서를 갱신합니다.
void	removeDocumentListener (DocumentListener listener) 문서 리스너를 삭제합니다.
void	removeStyle (String nm) 이전에 문서에 추가된 이름 첨부 서식을 삭제합니다.
protected void	removeUpdate (AbstractDocument.DefaultDocumentEvent chng) 텍스트 삭제의 결과로서 문서 구조를 갱신합니다.
void	setCharacterAttributes (int offset, int length, AttributeSet s, boolean replace) 문서의 일부에 속성을 설정합니다.
void	setLogicalStyle (int pos, Style s) 지정된 위치의 단락에 사용하는 논리 서식을 설정합니다.
void	setParagraphAttributes (int offset, int length, AttributeSet s, boolean replace) 단락에 속성을 설정합니다.
protected void	styleChanged (Style style) 이 문서의 서식이 변경되었을 때에 호출합니다.

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

addUndoableEditListener, createBranchElement, createLeafElement, createPosition, dump, fireChangedUpdate, fireInsertUpdate, fireRemoveUpdate, fireUndoableEditUpdate, 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

필드의 상세

BUFFER_SIZE_DEFAULT

public static final int BUFFER_SIZE_DEFAULT

초기 컨텐츠 버퍼의 디폴트 사이즈입니다.

관련 항목:

정수 필드값

buffer

protected DefaultStyledDocument.ElementBuffer  buffer

생성자 상세

DefaultStyledDocument

public DefaultStyledDocument(AbstractDocument.Content  c,
                             StyleContext  styles)

서식 첨부 문서를 구축합니다.

파라미터:

c - 컨텐츠의 컨테이너

styles - 문서간에 공유할 수 있는 자원과 서식 정의

DefaultStyledDocument

public DefaultStyledDocument(StyleContext  styles)

디폴트의 컨텐츠 기억역의 구현과 서식의 공유 세트를 사용해, 서식 첨부 문서를 구축합니다.

파라미터:

styles - 서식

DefaultStyledDocument

public DefaultStyledDocument()

디폴트의 서식 첨부 문서를 구축합니다. 이것은 입력 컨텐츠를 BUFFER_SIZE_DEFAULT 사이즈에 의해 버퍼 처리해, 문서의 수명에 의해 스코프 된 스타일 컨텍스트를 가져, 다른 문서와는 공유되지 않습니다.

메서드의 상세

getDefaultRootElement

public Element  getDefaultRootElement()

디폴트의 루트 요소를 리턴합니다.

정의:

인터페이스 Document 내의 getDefaultRootElement

정의:

클래스 AbstractDocument 내의 getDefaultRootElement

반환값:

루트

관련 항목:

Document.getDefaultRootElement()

create

protected void create(DefaultStyledDocument.ElementSpec [] data)

문서를 초기화해, 지정된 요소 구조 (getDefaultRootElement 메서드에 의해 보고되는 구조)를 반영합니다. 문서가 하등의 데이터를 보관 유지하고 있는 경우, 그것이 최초로 삭제됩니다.

insert

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

새로운 요소를 일괄해 삽입합니다. 이것은 락 해제 상태의 문서를 구문 분석 해, 요소 구조의 변경을 준비하는데 도움이 됩니다. 이 메서드는 요소 구조를 갱신하는 방법을 기술하는 토큰의 배열을 취득하므로 출력 락에 들어가는 시간을 비동기적인 갱신 상황으로 큰폭으로 줄일 수가 있습니다.

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

파라미터:

offset - 개시 오프셋(offset) >= 0

data - 요소 데이터

예외:

BadLocationException - 개시 오프셋(offset)가 무효인 경우

addStyle

public Style  addStyle(String  nm,
                      Style  parent)

논리 서식 계층에 새로운 서식을 추가합니다. 서식의 속성은 아래에서 위로 향해 해석 처리되므로자식 로 지정된 속성은 부모로 지정된 속성을 오버라이드(override) 합니다.

정의:

인터페이스 StyledDocument 내의 addStyle

파라미터:

nm - 서식의 이름. 이 이름은 이름 첨부 서식의 컬렉션 안에서 일의가 아니면 안된다. 이름은 서식에 이름이 붙지 않은 경우는 null도 가능하지만, 호출측은 이름이 없는 서식이 이름으로 취득할 수 없는 경우에 리턴된 참조를 관리해야 한다. 이름이 없는 서식은 스타일 런으로 볼 수 있는 것 같은 문자 속성의 오버라이드(override)등으로 편리한 경우가 있는

parent - 친서식. 지정되어 있지 않은 속성이 다른 서식에서 해석 처리될 필요가 없는 경우는 null도 가능

반환값:

서식

removeStyle

public void removeStyle(String  nm)

이전에 문서에 추가된 이름 첨부 서식을 삭제합니다.

정의:

인터페이스 StyledDocument 내의 removeStyle

파라미터:

nm - 삭제되는 서식의 이름

getStyle

public Style  getStyle(String  nm)

이전에 추가된 이름 첨부 서식을 꺼냅니다.

정의:

인터페이스 StyledDocument 내의 getStyle

파라미터:

nm - 서식의 이름

반환값:

서식

getStyleNames

public Enumeration <? > getStyleNames()

서식명의 리스트를 꺼냅니다.

반환값:

모든 서식명

setLogicalStyle

public void setLogicalStyle(int pos,
                            Style  s)

지정된 위치의 단락에 사용하는 논리 서식을 설정합니다. 문자 및 단락의 속성에 대해서 명시적으로 속성이 설정되어 있지 않은 경우, 속성은 그 단락에 할당할 수 있는 논리 서식을 개입시켜 해석 처리됩니다. 논리 서식은 문서내의 요소 계층에 전혀 존하지 않는 계층을 개입시켜 해석 처리됩니다.

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

정의:

인터페이스 StyledDocument 내의 setLogicalStyle

파라미터:

pos - 문서의 선두로부터의 오프셋(offset) >= 0

s - 단락에 할당할 수 있었던 논리 서식. 없는 경우는 null

getLogicalStyle

public Style  getLogicalStyle(int p)

지정된 위치에 의해 나타내진 단락에 할당할 수 있었던 논리 서식을 꺼냅니다.

정의:

인터페이스 StyledDocument 내의 getLogicalStyle

파라미터:

p - 단락으로 변환해, 할당하는 논리 서식을 지정하는 위치 >= 0. 이것은 문서의 선두로부터의 오프셋(offset)

반환값:

서식. 없는 경우는 null

setCharacterAttributes

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

문서의 일부에 속성을 설정합니다. 이 처리는 변경의 실행중에 출력락을 보관 유지해, 변경이 적절히 완료하면 DocumentEvent가 리스너에게 보내집니다.

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

정의:

인터페이스 StyledDocument 내의 setCharacterAttributes

파라미터:

offset - 문서의 오프셋(offset) >= 0

length - 길이 >= 0

s - 속성

replace - 새로운 속성의 설정전에 종래의 속성을 치환할 필요가 있는 경우는 true

setParagraphAttributes

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

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

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

정의:

인터페이스 StyledDocument 내의 setParagraphAttributes

파라미터:

offset - 단락에 대한 오프셋(offset) >= 0

length - 영향을 받는 문자수 >= 0

s - 속성

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

getParagraphElement

public Element  getParagraphElement(int pos)

오프셋(offset) pos 단락의 요소를 리턴합니다. 1개의 단락은 적어도 1개의, 일반적으로 잎인자식 의 Element 로부터 구성되어 있습니다.

정의:

인터페이스 StyledDocument 내의 getParagraphElement

정의:

클래스 AbstractDocument 내의 getParagraphElement

파라미터:

pos - 개시 오프셋(offset) >= 0

반환값:

요소

getCharacterElement

public Element  getCharacterElement(int pos)

위치에 근거해 문자 요소를 리턴합니다.

정의:

인터페이스 StyledDocument 내의 getCharacterElement

파라미터:

pos - 문서내의 위치 >= 0

반환값:

요소

insertUpdate

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

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

오버라이드(override):

클래스 AbstractDocument 내의 insertUpdate

파라미터:

chng - 문서 변경의 설명

attr - 속성

removeUpdate

protected void removeUpdate(AbstractDocument.DefaultDocumentEvent  chng)

텍스트 삭제의 결과로서 문서 구조를 갱신합니다.

오버라이드(override):

클래스 AbstractDocument 내의 removeUpdate

파라미터:

chng - 문서 변경의 설명

createDefaultRoot

protected AbstractDocument.AbstractElement  createDefaultRoot()

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

반환값:

요소 베이스

getForeground

public Color  getForeground(AttributeSet  attr)

속성 세트로부터 foreground 컬러를 리턴합니다.

정의:

인터페이스 StyledDocument 내의 getForeground

파라미터:

attr - 속성 세트

반환값:

색

getBackground

public Color  getBackground(AttributeSet  attr)

속성 세트로부터 백그라운드 컬러를 리턴합니다.

정의:

인터페이스 StyledDocument 내의 getBackground

파라미터:

attr - 속성 세트

반환값:

색

getFont

public Font  getFont(AttributeSet  attr)

속성 세트로부터 폰트를 리턴합니다.

정의:

인터페이스 StyledDocument 내의 getFont

파라미터:

attr - 속성 세트

반환값:

폰트

styleChanged

protected void styleChanged(Style  style)

이 문서의 서식이 변경되었을 때에 호출합니다. 서브 클래스에서는 무엇이 데미지를 받았는지 알수 있듯이 할 필요가 있는 일이 있습니다.

파라미터:

style - 변경된 Style

addDocumentListener

public void addDocumentListener(DocumentListener  listener)

문서 리스너를 추가해, 변경이 있었을 때에 통지되도록 합니다.

정의:

인터페이스 Document 내의 addDocumentListener

오버라이드(override):

클래스 AbstractDocument 내의 addDocumentListener

파라미터:

listener - 리스너

관련 항목:

Document.addDocumentListener(javax.swing.event.DocumentListener)

removeDocumentListener

public void removeDocumentListener(DocumentListener  listener)

문서 리스너를 삭제합니다.

정의:

인터페이스 Document 내의 removeDocumentListener

오버라이드(override):

클래스 AbstractDocument 내의 removeDocumentListener

파라미터:

listener - 리스너

관련 항목:

Document.removeDocumentListener(javax.swing.event.DocumentListener)