java.text
클래스 AttributedString

java.lang.Object 
  java.text.AttributedString

public class AttributedString
extends Object 

텍스트와 그 텍스트에 관련된 속성 정보를 보관 유지합니다. 텍스트를 읽어내는 사용자가 AttributedCharacterIterator 인터페이스 경유로 속성 첨부 텍스트에 액세스 할 필요가 있는 경우, 이 클래스를 실제의 데이터 스토리지로서 사용할 수 있습니다.

도입된 버전 :

1.2

관련 항목:

AttributedCharacterIterator, Annotation

생성자 개요

AttributedString (AttributedCharacterIterator text)
지정된 AttributedCharacterIterator가 표현하는 속성 첨부 텍스트를 가지는 AttributedString 인스턴스를 구축합니다.

AttributedString (AttributedCharacterIterator text, int beginIndex, int endIndex)
지정된 AttributedCharacterIterator가 표현하는 속성 첨부 텍스트의 부분 범위를 가지는 AttributedString 인스턴스를 구축합니다.

AttributedString (AttributedCharacterIterator text, int beginIndex, int endIndex, AttributedCharacterIterator.Attribute [] attributes)
지정된 AttributedCharacterIterator가 표현하는 속성 첨부 텍스트의 부분 범위를 가지는 AttributedString 인스턴스를 구축합니다.

AttributedString (String text)
지정된 텍스트를 가지는 AttributedString 인스턴스를 구축합니다.

AttributedString (String text, Map <? extends AttributedCharacterIterator.Attribute, ? > attributes)
지정된 텍스트와 속성을 가지는 AttributedString 인스턴스를 구축합니다.

메서드 개요

void	addAttribute (AttributedCharacterIterator.Attribute attribute, Object value) 속성을 캐릭터 라인 전체에 추가합니다.
void	addAttribute (AttributedCharacterIterator.Attribute attribute, Object value, int beginIndex, int endIndex) 속성을 캐릭터 라인의 부분 범위에 추가합니다.
void	addAttributes (Map <? extends AttributedCharacterIterator.Attribute, ? > attributes, int beginIndex, int endIndex) 일련의 속성을 캐릭터 라인의 부분 범위에 추가합니다.
AttributedCharacterIterator	getIterator () 이 캐릭터 라인의 내용 전체에 액세스 할 수 있는 AttributedCharacterIterator 인스턴스를 작성합니다.
AttributedCharacterIterator	getIterator (AttributedCharacterIterator.Attribute [] attributes) 이 캐릭터 라인의 선택된 내용에 액세스 할 수 있는 AttributedCharacterIterator 인스턴스를 작성합니다.
AttributedCharacterIterator	getIterator (AttributedCharacterIterator.Attribute [] attributes, int beginIndex, int endIndex) 이 캐릭터 라인의 선택된 내용에 액세스 할 수 있는 AttributedCharacterIterator 인스턴스를 작성합니다.

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

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

생성자 상세

AttributedString

public AttributedString(String  text)

지정된 텍스트를 가지는 AttributedString 인스턴스를 구축합니다.

파라미터:

text - 이 속성 첨부 캐릭터 라인의 텍스트

AttributedString

public AttributedString(String  text,
                        Map <?  extends AttributedCharacterIterator.Attribute,
? > attributes)

지정된 텍스트와 속성을 가지는 AttributedString 인스턴스를 구축합니다.

파라미터:

text - 이 속성 첨부 캐릭터 라인의 텍스트

attributes - 캐릭터 라인 전체에 적용하는 속성

예외:

IllegalArgumentException - 텍스트장이 0 으로 한편 속성 파라미터가 비어있는 Map이 아닌 경우 (길이 0 범위에는 속성을 적용할 수 없다)

AttributedString

public AttributedString(AttributedCharacterIterator  text)

지정된 AttributedCharacterIterator가 표현하는 속성 첨부 텍스트를 가지는 AttributedString 인스턴스를 구축합니다.

파라미터:

text - 이 속성 첨부 캐릭터 라인의 텍스트

AttributedString

public AttributedString(AttributedCharacterIterator  text,
                        int beginIndex,
                        int endIndex)

지정된 AttributedCharacterIterator가 표현하는 속성 첨부 텍스트의 부분 범위를 가지는 AttributedString 인스턴스를 구축합니다. 지정된 범위가 비어있는 텍스트를 생성하는 경우, 모든 속성이 파기됩니다. 원의 속성 범위의 부분 범위에 대해서는 Annotation 객체에 의해 랩 된 속성은 모두 파기됩니다.

파라미터:

text - 이 속성 첨부 캐릭터 라인의 텍스트

beginIndex - 범위의 선두 문자의 인덱스

endIndex - 범위의 말미 문자의 다음의 문자의 인덱스

예외:

IllegalArgumentException - beginIndex와 endIndex 로 지정된 부분 범위가 텍스트의 범위외에 있는 경우

관련 항목:

Annotation

AttributedString

public AttributedString(AttributedCharacterIterator  text,
                        int beginIndex,
                        int endIndex,
                        AttributedCharacterIterator.Attribute [] attributes)

지정된 AttributedCharacterIterator가 표현하는 속성 첨부 텍스트의 부분 범위를 가지는 AttributedString 인스턴스를 구축합니다. 지정된 속성에 일치하는 속성만이 인스턴스에 짜넣어집니다. 지정된 범위가 비어있는 텍스트를 생성하는 경우, 모든 속성이 파기됩니다. 원의 속성 범위의 부분 범위에 대해서는 Annotation 객체에 의해 랩 된 속성은 모두 파기됩니다.

파라미터:

text - 이 속성 첨부 캐릭터 라인의 텍스트

beginIndex - 범위의 선두 문자의 인덱스

endIndex - 범위의 말미 문자의 다음의 문자의 인덱스

attributes - 텍스트로부터 추출하는 속성. null이 지정되었을 경우, 이용 가능한 모든 속성이 사용된다

예외:

IllegalArgumentException - beginIndex와 endIndex 로 지정된 부분 범위가 텍스트의 범위외에 있는 경우

관련 항목:

Annotation

메서드의 상세

addAttribute

public void addAttribute(AttributedCharacterIterator.Attribute  attribute,
                         Object  value)

속성을 캐릭터 라인 전체에 추가합니다.

파라미터:

attribute - 속성의 키

value - 속성의 값. null도 지정 가능

예외:

IllegalArgumentException - AttributedString 길이가 0인 경우 (길이 0 범위에는 속성을 적용할 수 없다)

addAttribute

public void addAttribute(AttributedCharacterIterator.Attribute  attribute,
                         Object  value,
                         int beginIndex,
                         int endIndex)

속성을 캐릭터 라인의 부분 범위에 추가합니다.

파라미터:

attribute - 속성의 키

value - 속성의 값. null도 지정 가능

beginIndex - 범위의 선두 문자의 인덱스

endIndex - 범위의 말미 문자의 다음의 문자의 인덱스

예외:

IllegalArgumentException - beginIndex가 0 보다 작은 경우, endIndex가 캐릭터 라인 길이보다 큰 경우, 혹은 beginIndex와 endIndex 로 정의되는 캐릭터 라인의 부분 범위가 비우는 경우

addAttributes

public void addAttributes(Map <?  extends AttributedCharacterIterator.Attribute,
? > attributes,
                          int beginIndex,
                          int endIndex)

일련의 속성을 캐릭터 라인의 부분 범위에 추가합니다.

파라미터:

attributes - 캐릭터 라인에 추가하는 속성

beginIndex - 범위의 선두 문자의 인덱스

endIndex - 범위의 말미 문자의 다음의 문자의 인덱스

예외:

IllegalArgumentException - beginIndex가 0 보다 작은 경우, endIndex가 캐릭터 라인 길이보다 큰 경우, 혹은 beginIndex와 endIndex 로 정의되는 캐릭터 라인의 부분 범위가 비어있는데 속성 파라미터는 비어있는 Map이 아닌 경우

getIterator

public AttributedCharacterIterator  getIterator()

이 캐릭터 라인의 내용 전체에 액세스 할 수 있는 AttributedCharacterIterator 인스턴스를 작성합니다.

반환값:

텍스트와 그 속성에 액세스 할 수 있는 반복자

getIterator

public AttributedCharacterIterator  getIterator(AttributedCharacterIterator.Attribute [] attributes)

이 캐릭터 라인의 선택된 내용에 액세스 할 수 있는 AttributedCharacterIterator 인스턴스를 작성합니다. attributes에 포함되지 않은 속성의 정보를 구현자가 보관 유지하는 경우, 그러한 정보를 이 반복자 경유로 액세스 가능하게 할 필요는 없습니다. 리스트가 null인 경우, 이용 가능한 모든 속성의 정보에 액세스 할 수 있을 필요가 있습니다.

파라미터:

attributes - 클라이언트가 흥미를 가지고 있는 속성의 리스트

반환값:

텍스트 및 텍스트의 속성에 액세스 할 수 있는 반복자

getIterator

public AttributedCharacterIterator  getIterator(AttributedCharacterIterator.Attribute [] attributes,
                                               int beginIndex,
                                               int endIndex)

이 캐릭터 라인의 선택된 내용에 액세스 할 수 있는 AttributedCharacterIterator 인스턴스를 작성합니다. attributes에 포함되지 않은 속성의 정보를 구현자가 보관 유지하는 경우, 그러한 정보를 이 반복자 경유로 액세스 가능하게 할 필요는 없습니다. 리스트가 null인 경우, 이용 가능한 모든 속성의 정보에 액세스 할 수 있을 필요가 있습니다.

파라미터:

attributes - 클라이언트가 흥미를 가지고 있는 속성의 리스트

beginIndex - 선두 문자의 인덱스

endIndex - 말미 문자의 다음의 문자의 인덱스

반환값:

텍스트 및 텍스트의 속성에 액세스 할 수 있는 반복자

예외:

IllegalArgumentException - beginIndex가 0 보다 작은 경우, endIndex가 캐릭터 라인 길이보다 큰 경우, 혹은 beginIndex가 endIndex 보다 큰 경우