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인 경우