java.text
클래스 AttributedString

java.lang.Object 
  |
  +--java.text.AttributedString

public class AttributedString

extends Object

텍스트와 그 텍스트에 관련하는 속성 정보를 보관 유지합니다. 텍스트를 읽은 유저가 AttributedCharacterIterator 인터페이스를 사용해 속성 첨부 텍스트에 액세스 하는 것이 필요한 경우에, 이것을 실제의 데이터 스토리지로서 사용할 수 있습니다.

관련 항목:

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 attributes)
지정된 텍스트와 속성을 가지는 AttributedString 의 인스턴스를 생성합니다.

메소드의 개요

void	addAttribute (AttributedCharacterIterator.Attribute attribute, Object value) 속성을 캐릭터 라인 전체에 추가합니다.
void	addAttribute (AttributedCharacterIterator.Attribute attribute, Object value, int beginIndex, int endIndex) 속성을 캐릭터 라인의 부분 범위에 추가합니다.
void	addAttributes (Map 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  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  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 의 인스턴스를 생성합니다. 구현자가 가질 가능성이 없는 속성에 대한 정보는 반복자를 사용해 액세스 가능하게 할 필요는 없습니다. 구현자가 가지는 속성의 리스트가 null 의 경우, 이용 가능한 모든 속성 정보는 액세스 가능하게 해 주세요.

파라미터:

attributes - 클라이언트가 관심을 가지는 속성의 리스트

반환값:

텍스트와 그 속성에의 액세스를 제공하는 반복자

getIterator

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

캐릭터 라인의 선택된 내용에의 액세스를 제공하는 AttributedCharacterIterator 의 인스턴스를 생성합니다. 구현자가 가질 가능성이 없는 속성에 대한 정보는 반복자를 사용해 액세스 가능하게 할 필요는 없습니다. 구현자가 가지는 속성의 리스트가 null 의 경우, 이용 가능한 모든 속성 정보는 액세스 가능하게 해 주세요.

파라미터:

attributes - 클라이언트가 관심을 가지는 속성의 리스트

beginIndex - 선두 캐릭터의 인덱스

endIndex - 마지막 캐릭터의 다음에 오는 캐릭터의 인덱스

반환값:

텍스트와 그 속성에의 액세스를 제공하는 반복자

예외:

IllegalArgumentException - beginIndex 가 0 보다 작은 경우, endIndex 가 캐릭터 라인장보다 큰 경우, 또는 beginIndex 가 endIndex 보다 큰 경우