java.awt.font
클래스 TextMeasurer

java.lang.Object 
  |
  +--java.awt.font.TextMeasurer

모든 구현 인터페이스:

Cloneable

public final class TextMeasurer

extends Object

implements Cloneable

TextMeasurer 클래스는 유효폭의 측정, 캐릭터 범위의 유효폭의 지정, 캐릭터 범위의 TextLayout 의 작성 등, 개행에 필요한 기본 조작을 제공합니다. 패러그래프가 증가했을 경우의 편집 메소드도 제공합니다.

TextMeasurer 오브젝트는 텍스트의 1 개의 패러그래프를 나타내는 AttributedCharacterIterator 로 구축합니다. AttributedCharacterIterator 의 getBeginIndex 메소드가 돌려주는 값은 최초의 캐릭터의 절대 인덱스를 정의합니다. AttributedCharacterIterator 의 getEndIndex 메소드가 돌려주는 값은 마지막 캐릭터의 다음의 인덱스를 정의합니다. 이러한 값에 의해,TextMeasurer 를 호출할 때 사용하는 인덱스의 범위가 정의됩니다. 예를 들어, 텍스트의 범위의 유효폭, 즉 텍스트의 범위의 개행을 취득하기 위한 호출에서는 개시 인덱스치와 종료 인덱스치의 사이의 인덱스를 사용할 필요가 있습니다. insertChar 및 deleteChar 를 호출하면(자),TextMeasurer 가 리셋트 되어 이러한 호출로 건네받은 AttributedCharacterIterator 의 개시 인덱스와 종료 인덱스가 사용됩니다.

대부분의 클라이언트는 표준 개행 (각 행에 배치 가능한 한의 캐릭터를 배치)을 구현하는 편리한 LineBreakMeasurer 를 사용합니다.

도입된 버젼:

1.3

관련 항목:

LineBreakMeasurer

생성자의 개요

TextMeasurer (AttributedCharacterIterator text, FontRenderContext frc)
소스 텍스트로부터 TextMeasurer 를 구축합니다.

메소드의 개요

protected Object	clone () 이 오브젝트의 카피를 작성해 돌려줍니다.
void	deleteChar (AttributedCharacterIterator newParagraph, int deletePos) 이 TextMeasurer 가 현재 나타내는 패러그래프로 1 캐릭터를 삭제하고 나서 TextMeasurer 를 갱신합니다.
float	getAdvanceBetween (int start, int limit) start 로 시작되어,limit 까지의 캐릭터를 포함한 행의 그래픽폭을 돌려줍니다.
TextLayout	getLayout (int start, int limit) 지정된 캐릭터 범위의 TextLayout 를 돌려줍니다.
int	getLineBreakIndex (int start, float maxAdvance) start 로 시작되어, 그래픽폭이 maxAdvance 의 행에 배치할 수 없는 최초의 캐릭터의 인덱스를 돌려줍니다.
void	insertChar (AttributedCharacterIterator newParagraph, int insertPos) 이 TextMeasurer 가 현재 나타내는 패러그래프에 1 캐릭터를 삽입하고 나서 TextMeasurer 를 갱신합니다.

클래스 java.lang. Object 에서 상속받은 메소드

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

생성자의 상세

TextMeasurer

public TextMeasurer(AttributedCharacterIterator  text,
                    FontRenderContext  frc)

소스 텍스트로부터 TextMeasurer 를 구축합니다. 소스 텍스트는 1 단락 전체가 됩니다.

파라미터:

text - 소스 단락. null 는 불가

frc - 텍스트를 정확하게 측정하는 경우에 필요한 그래픽스 디바이스에 관한 정보. null 는 불가

메소드의 상세

clone

protected Object  clone()

클래스 Object 의 기술:

이 오브젝트의 카피를 작성해 돌려줍니다. 「카피」의 정확한 이유는 오브젝트의 클래스에 의해 다릅니다. 일반적으로는 임의의 오브젝트 x 에 대해, 다음의 식

 x.clone() ! = x

하지만 true 이며, 다음의 식

 x.clone(). getClass() == x.getClass()

도 true 인 것입니다만, 이것들도 절대적인 요건이 아닙니다. 또 다음의 식

 x.clone(). equals(x)

도 통상 true 가 됩니다만, 이것도 절대적인 요건이 아닙니다.

통상,super.clone 를 호출하는 것으로 돌려주어지는 오브젝트를 취득할 수 있습니다. 클래스 및 그 슈퍼 클래스 모든 것 (Object 를 제외한다)이 이 규칙에 따르는 경우,x.clone(). getClass() == x.getClass() 가 성립합니다.

통상, 이 메소드에 의해 돌려주어지는 오브젝트는 이 오브젝트 (복제되고 있다)로부터 독립하고 있을 필요가 있습니다. 이 독립성을 달성하기 위해(때문에),super.clone 가 돌려주는 오브젝트의 필드를 1 개 이상 (오브젝트가 돌려주기 전에) 변경하는 것이 필요하게 되는 경우가 있습니다. 이것은 통상, 복제하는 오브젝트의 내부 「심층 구조」를 구성하는 가변 오브젝트의 카피, 및 이러한 오브젝트에의 참조를 카피에의 참조에 옮겨놓는 것을 의미합니다. 클래스에 원시적 필드 또는 불변 오브젝트에의 참조만이 포함되는 경우, 통상,super.clone 에 의해 돌려주어지는 오브젝트내의 필드를 변경할 필요는 없습니다.

Object 클래스의 clone 메소드는 특정의 복제 처리를 실행합니다. 우선, 이 오브젝트의 클래스가 Cloneable 인터페이스를 구현하고 있지 않는 경우는 CloneNotSupportedException 가 슬로우 됩니다. 배열은 모두, 인터페이스 Cloneable 를 구현하고 있는 것이라고 보여지는 것에 주의해 주세요. 구현하고 있지 않는 경우, 이 메소드는 이 오브젝트의 클래스의 새로운 인스턴스를 생성해, 그 필드를 모두, 이 오브젝트의 대응하는 각 필드의 내용으로 초기화합니다. 이것은 대입과 같아, 필드의 내용 자신이 복제되는 것은 아닙니다. 즉 이 메소드는 오브젝트의 샤로코피를 생성합니다만, 딥 카피는 생성하지 않습니다.

클래스 Object 자체는 Cloneable 인터페이스를 구현하지 않기 때문에, 클래스가 Object 인 clone 메소드를 호출하면(자), 실행시에 예외가 슬로우 됩니다.

오버라이드(override):

클래스 Object 내의 clone

반환값:

이 인스턴스의 복제

관련 항목:

Cloneable

getLineBreakIndex

public int getLineBreakIndex(int start,
                             float maxAdvance)

start 로 시작되어, 그래픽폭이 maxAdvance 의 행에 배치할 수 없는 최초의 캐릭터의 인덱스를 돌려줍니다.

파라미터:

start - 측정을 개시하는 위치의 캐릭터 인덱스. start 는 절대 인덱스로, 패러그래프의 스타트에 관한 것이 아닌

maxAdvance - 행을 배치하는 그래픽폭

반환값:

start 로 시작되어, 그래픽폭이 maxAdvance 이내의 행에 배치할 수 있는 마지막 캐릭터의 뒤의 인덱스

예외:

IllegalArgumentException - start 가 패러그래프의 개시 위치보다 전의 경우

getAdvanceBetween

public float getAdvanceBetween(int start,
                               int limit)

start 로 시작되어,limit 까지의 캐릭터를 포함한 행의 그래픽폭을 돌려줍니다. start 와 limit 는 절대 인덱스로, 패러그래프의 스타트에는 관련하지 않습니다.

파라미터:

start - 측정을 개시하는 장소의 캐릭터 인덱스

limit - 측정을 종료하는 장소의 캐릭터 인덱스

반환값:

start 로부터 시작되어,limit 까지의 캐릭터를 포함한 행의 그래픽폭

예외:

IndexOutOfBoundsException - limit 가 start 보다 전의 경우

IllegalArgumentException - start 또는 limit 가 패러그래프의 개시 위치와 종료 위치동안에 없는 경우

getLayout

public TextLayout  getLayout(int start,
                            int limit)

지정된 캐릭터 범위의 TextLayout 를 돌려줍니다.

파라미터:

start - 최초의 캐릭터의 인덱스

limit - 텍스트내의 마지막 캐릭터의 다음의 인덱스. start 보다 크지 않으면 안 된다

반환값:

start 로부터 시작되어,limit 보다 작은 캐릭터의 TextLayout

예외:

IndexOutOfBoundsException - limit 가 start 보다 전의 경우

IllegalArgumentException - start 또는 limit 가 패러그래프의 개시 위치와 종료 위치동안에 없는 경우

insertChar

public void insertChar(AttributedCharacterIterator  newParagraph,
                       int insertPos)

이 TextMeasurer 가 현재 나타내는 패러그래프에 1 캐릭터를 삽입하고 나서 TextMeasurer 를 갱신합니다. 이 호출의 뒤,TextMeasurer 는 텍스트로부터 작성된 새로운 TextMeasurer 와 동등하게 됩니다. 그러나, 통상은 완전히 제로로부터 새로운 것을 작성하는 것보다 기존의 TextMeasurer 를 갱신한 (분)편이 효율적입니다.

파라미터:

newParagraph - 삽입을 한 후의 패러그래프의 텍스트. null 는 불가

insertPos - 캐릭터를 삽입한 텍스트의 위치. newParagraph 의 개시 위치에서(보다) 나중에,newParagraph 의 종료 위치보다 전

예외:

IndexOutOfBoundsException - insertPos 가 newParagraph 의 개시 위치보다 전, 또는 newParagraph 의 종료 위치와 같은가, 그 이후인 경우

NullPointerException - newParagraph 가 null 의 경우

deleteChar

public void deleteChar(AttributedCharacterIterator  newParagraph,
                       int deletePos)

이 TextMeasurer 가 현재 나타내는 패러그래프로 1 캐릭터를 삭제하고 나서 TextMeasurer 를 갱신합니다. 이 호출의 뒤,TextMeasurer 는 텍스트로부터 작성된 새로운 TextMeasurer 와 동등하게 됩니다. 그러나, 통상은 완전히 제로로부터 새로운 것을 작성하는 것보다 기존의 TextMeasurer 를 갱신한 (분)편이 효율적입니다.

파라미터:

newParagraph - 삭제를 한 후의 패러그래프의 텍스트. null 는 불가

deletePos - 캐릭터를 삭제한 텍스트의 위치. newParagraph 의 개시 위치에서(보다) 나중에,newParagraph 의 종료 위치보다 전

예외:

IndexOutOfBoundsException - deletePos 가 newParagraph 의 개시 위치보다 전, 또는 newParagraph 의 종료 위치에서(보다) 뒤인 경우

NullPointerException - newParagraph 가 null 의 경우