javax.swing.text
클래스 StringContent

java.lang.Object 
  javax.swing.text.StringContent

모든 구현된 인터페이스:

Serializable , AbstractDocument.Content

public final class StringContent
extends Object 
implements AbstractDocument.Content , Serializable 

비교적 작은 문서 및 디버그에는 편리한, 강행인 구현인 AbstractDocument.Content 인터페이스의 구현입니다. 이것은, 문자 컨텐츠를 단순한 문자 배열로서 관리합니다. 이것도 효율적이 아닙니다.

대신에, 갭 버퍼 또는 부분 테이블의 구현을 사용하는 것을 추천합니다. 이 버퍼는 사이즈가 커지지 않습니다.

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

생성자 의 개요

StringContent ()
새로운 StringContent 객체를 작성합니다.

StringContent (int initialLength)
지정된 초기 사이즈로 새로운 StringContent 객체를 작성합니다.

메소드의 개요

Position	createPosition (int offset) 컨텐츠가 변경되었을 때에 변경을 추적하는 컨텐츠내의 위치를 작성합니다.
void	getChars (int where, int len, Segment chars) 컨텐츠의 일부를 꺼냅니다.
protected Vector	getPositionsInRange (Vector v, int offset, int length) offset ~ offset + length 의 범위에 있는 위치에 대응하는 UndoPosRef 의 인스턴스를 포함한 벡터를 돌려줍니다.
String	getString (int where, int len) 컨텐츠의 일부를 꺼냅니다.
UndoableEdit	insertString (int where, String str) 컨텐츠에 캐릭터 라인을 삽입합니다.
int	length () 컨텐츠의 길이를 돌려줍니다.
UndoableEdit	remove (int where, int nitems) 컨텐츠의 일부를 삭제합니다.
protected void	updateUndoPositions (Vector positions) positions 의 모든 UndoPosRef 인스턴스의 위치를 리셋 합니다.

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

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

생성자 의 상세

StringContent

public StringContent()

새로운 StringContent 객체를 작성합니다. 초기 사이즈의 디폴트는 10 입니다.

StringContent

public StringContent(int initialLength)

지정된 초기 사이즈로 새로운 StringContent 객체를 작성합니다. 길이가 1 보다 작은 경우, 사이즈 1 이 사용됩니다.

파라미터:

initialLength - 초기 사이즈

메소드의 상세

length

public int length()

컨텐츠의 길이를 돌려줍니다.

정의:

인터페이스 AbstractDocument.Content 내의 length

반환값:

길이 >= 1

관련 항목:

AbstractDocument.Content.length()

insertString

public UndoableEdit  insertString(int where,
                                 String  str)
                          throws BadLocationException 

컨텐츠에 캐릭터 라인을 삽입합니다.

정의:

인터페이스 AbstractDocument.Content 내의 insertString

파라미터:

where - 개시 위치 >= 0 && < length()

str - 삽입하는 null 이외의 캐릭터 라인

반환값:

바탕으로 되돌리기 위한 UndoableEdit 객체

예외:

BadLocationException - 지정된 위치가 무효인 경우

관련 항목:

AbstractDocument.Content.insertString(int, java.lang.String)

remove

public UndoableEdit  remove(int where,
                           int nitems)
                    throws BadLocationException 

컨텐츠의 일부를 삭제합니다. where + nitems 는, length()보다 작아지고 있을 필요가 있습니다.

정의:

인터페이스 AbstractDocument.Content 내의 remove

파라미터:

where - 개시 위치 >= 0

nitems - 삭제 대상의 문자수 >= 0

반환값:

바탕으로 되돌리기 위한 UndoableEdit 객체

예외:

BadLocationException - 지정된 위치가 무효인 경우

관련 항목:

AbstractDocument.Content.remove(int, int)

getString

public String  getString(int where,
                        int len)
                 throws BadLocationException 

컨텐츠의 일부를 꺼냅니다. where + len 는, length() 이하가 되어 있을 필요가 있습니다.

정의:

인터페이스 AbstractDocument.Content 내의 getString

파라미터:

where - 개시 위치 >= 0

len - 꺼내는 길이 >= 0

반환값:

컨텐츠를 나타내는 캐릭터 라인. 빈 상태(empty)의 경우도 있다

예외:

BadLocationException - 지정된 위치가 무효인 경우

관련 항목:

AbstractDocument.Content.getString(int, int)

getChars

public void getChars(int where,
                     int len,
                     Segment  chars)
              throws BadLocationException 

컨텐츠의 일부를 꺼냅니다. where + len 는, length() 이하가 되어 있을 필요가 있습니다.

정의:

인터페이스 AbstractDocument.Content 내의 getChars

파라미터:

where - 개시 위치 >= 0

len - 검색 대상의 문자수 >= 0

chars - 문자를 돌려주는 앞의 Segment 객체

예외:

BadLocationException - 지정된 위치가 무효인 경우

관련 항목:

AbstractDocument.Content.getChars(int, int, javax.swing.text.Segment)

createPosition

public Position  createPosition(int offset)
                        throws BadLocationException 

컨텐츠가 변경되었을 때에 변경을 추적하는 컨텐츠내의 위치를 작성합니다.

정의:

인터페이스 AbstractDocument.Content 내의 createPosition

파라미터:

offset - 위치를 작성하는 오프셋(offset) >= 0

반환값:

위치

예외:

BadLocationException - 지정된 위치가 무효인 경우

getPositionsInRange

protected Vector  getPositionsInRange(Vector  v,
                                     int offset,
                                     int length)

offset ~ offset + length 의 범위에 있는 위치에 대응하는 UndoPosRef 의 인스턴스를 포함한 벡터를 돌려줍니다. v 가 null 가 아닌 경우, 일치하는 위치가 거기에 배치됩니다. 결과적으로 얻을 수 있는 위치를 가지는 벡터가 돌려주어집니다.

이것은 내부에서의 사용을 목적으로 하고 있어, 일반적으로는 서브 클래스를 대상으로 하고 있지 않습니다.

파라미터:

v - 사용하는 벡터. null 의 경우는 새로운 벡터가 작성되는

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

length - 길이 >= 0

반환값:

인스턴스세트

updateUndoPositions

protected void updateUndoPositions(Vector  positions)

positions 의 모든 UndoPosRef 인스턴스의 위치를 리셋 합니다.

이것은 내부에서의 사용을 목적으로 하고 있어, 일반적으로는 서브 클래스를 대상으로 하고 있지 않습니다.

파라미터:

positions - 인스턴스의 위치