javax.swing.text
클래스 DefaultStyledDocument

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

모든 구현 인터페이스:

Document , Serializable , StyledDocument

직계의 기존의 서브 클래스:

HTMLDocument

public class DefaultStyledDocument

extends AbstractDocument

implements StyledDocument

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

경고: 이 클래스의 직렬화 된 오브젝트는 향후의 Swing 의 릴리스와는 호환성을 가지지 않습니다. 현재의 직렬화 서포트는 단기간의 운용이나, 같은 버젼의 Swing 를 실행하는 어플리케이션간의 RMI 에 적절하고 있습니다. 1.4 에서는 모든 JavaBeans^TM 의 장기 운용 서포트가, java.beans 패키지에 추가되었습니다. XMLEncoder 를 참조해 주세요.

관련 항목:

Document , AbstractDocument

중첩된 클래스의 개요

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

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

AbstractDocument.AttributeContext , 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 - 기존의 속성을 치환하는지 merge 할까

getParagraphElement

public Element  getParagraphElement(int pos)

오프셋(offset) pos 의 단락의 요소를 돌려줍니다. 1 개의 단락은 적어도 1 kr의, 통상은 잎인 아이의 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)