java.awt
클래스 FontMetrics

java.lang.Object 
  |
  +--java.awt.FontMetrics

모든 구현 인터페이스:

Serializable

public abstract class FontMetrics

extends Object

implements Serializable

FontMetrics 클래스는 특정의 화면에서의 특정의 폰트에 관한 표현 정보를 캡슐화하는 폰트 시학 오브젝트를 정의합니다.

서브 클래스에 대한 주의: 이러한 메소드의 상당수는 서로 재귀적인 닫은 루프를 형성하기 위해(때문에), 서브 클래스를 사용할 때는 무한의 재귀를 피하기 위해서(때문에), 이러한 루프의 각각에 적어도 1 개의 메소드를 구현하도록(듯이) 유의할 필요가 있습니다. 특히 다음에 드는 것은 정확함을 프로텍션해 무한의 재귀를 피하기 위해서(때문에), 오버라이드(override)가 추천 되는 최저한의 메소드입니다 (같은 메소드는 그 밖에도 있습니다).

• getAscent()
• getLeading()
• getMaxAdvance()
• charWidth(char)
• charsWidth(char[], int, int)

이 클래스의 각 메소드에서의 구현은 효율적은 아니기 때문에, 통상은 보다 효율적인 툴 킷 특유의 구현으로 오버라이드(override) 되고 있는 것에 주의해 주세요.

어플리케이션이 AWT 에 대해서 좌표 (x, y)에 캐릭터를 배치하도록(듯이) 요구하면(자), 캐릭터는 그 참조 포인트 (첨부 이미지로 닷으로서 표시되고 있다)가 그 위치에 놓여지도록(듯이) 배치됩니다. 참조 포인트는 캐릭터의 「baseline」라고 불리는 수평 라인을 지정합니다. 통상의 출력으로는 캐릭터의 baseline의 위치 가지런히 하고를 해 주세요.

게다가 폰트의 모든 캐릭터는 「아센트」, 「디 센트」, 및 「유효폭」을 가집니다. 아센트는 baseline로부터 캐릭터의 상단까지의 양입니다. 디 센트는 baseline로부터 캐릭터의 하단까지의 양입니다. 유효폭은 AWT 에 의한 다음의 캐릭터의 배치 위치를 나타냅니다.

캐릭터 배열 또는 캐릭터 라인도, 아센트, 디 센트, 및 유효폭을 가질 수가 있습니다. 배열의 아센트는 배열내의 캐릭터의 최대 아센트입니다. 디 센트는 배열내의 캐릭터의 최대 디 센트입니다. 유효폭은 배열내의 각 캐릭터의 유효폭의 합계입니다. 유효 String 는 String 의 baseline에 따른 거리입니다. 이 거리는 String 의 센터링 또는 오른쪽맞춤을 위해서(때문에) 사용되는 폭입니다. 캐릭터의 폭은 그 문맥에 의해 격차가 있기 (위해)때문에, 유효 String 는 반드시 단독으로 측정한 캐릭터의 합계는 아닌 것에 주의해 주세요. 예를 들어, 아라비아어의 텍스트의 경우, 다른 캐릭터와 결합하기 위해서 캐릭터의 형태가 바뀝니다. 다른 스크립트의 경우에서도, 특정의 캐릭터 순차 순서는합자라고 하는 단일 형상으로 표현됩니다. 개개에 캐릭터를 카운트 할 때에는 이러한 변환은 카운트 되지 않습니다.

도입된 버젼:

JDK1. 0

관련 항목:

Font , 직렬화 된 형식

필드의 개요

protected Font

font 폰트메트릭스의 생성측이 되는 실제의 Font 입니다.

생성자의 개요

protected

FontMetrics (Font font) 지정된 Font 의 높이와 폭, 및 그 Font 의 특정의 캐릭터 글리프(glyph)를 조사하기 위한 새로운 FontMetrics 오브젝트를 생성합니다.

메소드의 개요

int	bytesWidth (byte[] data, int off, int len) 지정된 캐릭터 배열을 이 Font 로 표시하기 위한 유효폭의 합계를 돌려줍니다.
int	charsWidth (char[] data, int off, int len) 지정된 캐릭터 배열을 이 Font 로 표시하기 위한 유효폭의 합계를 돌려줍니다.
int	charWidth (char ch) 이 Font 의 지정한 캐릭터의 유효폭을 돌려줍니다.
int	charWidth (int ch) 이 Font 의 지정한 캐릭터의 유효폭을 돌려줍니다.
int	getAscent () 이 FontMetrics 오브젝트가 기술하는 Font 의 「폰트아센트」를 판정합니다.
int	getDescent () 이 FontMetrics 오브젝트가 기술하는 Font 의 「폰트 디 센트」를 판정합니다.
Font	getFont () 이 FontMetrics 오브젝트가 기술하는 Font 를 돌려줍니다.
int	getHeight () 이 폰트의 텍스트 1 행의 표준의 높이를 취득합니다.
int	getLeading () 이 FontMetrics 오브젝트가 기술하는 Font 의 「표준 leading」를 판정합니다.
LineMetrics	getLineMetrics (char[] chars, int beginIndex, int limit, Graphics context) 지정된 Graphics 문맥으로, 지정된 캐릭터 배열의 LineMetrics 오브젝트를 돌려줍니다.
LineMetrics	getLineMetrics (CharacterIterator ci, int beginIndex, int limit, Graphics context) 지정된 Graphics 문맥으로, 지정된 CharacterIterator 의 LineMetrics 오브젝트를 돌려줍니다.
LineMetrics	getLineMetrics (String str, Graphics context) 지정된 Graphics 문맥으로, 지정된 String 의 LineMetrics 오브젝트를 돌려줍니다.
LineMetrics	getLineMetrics (String str, int beginIndex, int limit, Graphics context) 지정된 Graphics 문맥으로, 지정된 String 의 LineMetrics 오브젝트를 돌려줍니다.
int	getMaxAdvance () 이 Font 의 캐릭터의 최대 유효폭을 돌려줍니다.
int	getMaxAscent () 이 FontMetrics 오브젝트가 기술하는 Font 의 최대 아센트를 판정합니다.
Rectangle2D	getMaxCharBounds (Graphics context) 지정된 Graphics 문맥으로, 최대의 경계를 가지는 캐릭터의 경계를 돌려줍니다.
int	getMaxDecent () 추천 되고 있지 않습니다. JDK 버젼 1.1. 1 이후는 getMaxDescent() 를 사용
int	getMaxDescent () 이 FontMetrics 오브젝트가 기술하는 Font 의 최대 디 센트를 판정합니다.
Rectangle2D	getStringBounds (char[] chars, int beginIndex, int limit, Graphics context) 지정된 Graphics 문맥으로, 지정된 캐릭터 배열의 경계를 돌려줍니다.
Rectangle2D	getStringBounds (CharacterIterator ci, int beginIndex, int limit, Graphics context) 지정된 Graphics 문맥으로, 지정된 CharacterIterator 내의 인덱스 첨부 캐릭터 라인의 경계를 돌려줍니다.
Rectangle2D	getStringBounds (String str, Graphics context) 지정된 Graphics 문맥으로, 지정된 String 의 경계를 돌려줍니다.
Rectangle2D	getStringBounds (String str, int beginIndex, int limit, Graphics context) 지정된 Graphics 문맥으로, 지정된 String 의 경계를 돌려줍니다.
int[]	getWidths () 이 Font 의 최초의 256 캐릭터의 유효폭을 취득합니다.
boolean	hasUniformLineMetrics () Font 가 균일의 라인메트릭스를 가질지 어떨지를 판정합니다.
int	stringWidth (String str) 지정된 String 를, 이 Font 로 표시하기 위한 유효폭의 합계를 돌려줍니다.
String	toString () 이 FontMetrics 오브젝트의 값의 String 표현을 돌려줍니다.

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

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

필드의 상세

font

protected Font  font

폰트메트릭스의 생성측이 되는 실제의 Font 입니다. null 를 지정할 수 없습니다.

관련 항목:

getFont()

생성자의 상세

FontMetrics

protected FontMetrics(Font  font)

지정된 Font 의 높이와 폭, 및 그 Font 의 특정의 캐릭터 글리프(glyph)를 조사하기 위한 새로운 FontMetrics 오브젝트를 생성합니다.

파라미터:

font - Font

관련 항목:

Font

메소드의 상세

getFont

public Font  getFont()

이 FontMetrics 오브젝트가 기술하는 Font 를 돌려줍니다.

반환값:

이 FontMetrics 오브젝트가 기술하는 Font

getLeading

public int getLeading()

이 FontMetrics 오브젝트가 기술하는 Font 의 「표준 leading」를 판정합니다. 표준 leading (행간의 간격)는 텍스트가 있는 행의 디 센트와 그 다음의 행의 아센트의 사이에 확보되는 논리적인 양입니다. 높이의 메트릭스는 이 여분의 공간을 포함해 계산됩니다.

반환값:

Font 의 표준 leading

관련 항목:

getHeight() , getAscent() , getDescent()

getAscent

public int getAscent()

이 FontMetrics 오브젝트가 기술하는 Font 의 「폰트아센트」를 판정합니다. 폰트아센트는 폰트의 baseline로부터 대부분의 영숫자의 상단까지의 거리입니다. Font 의 캐릭터에 따라서는 폰트의 아센트라인으로부터 초과하는 경우가 있습니다.

반환값:

Font 의 폰트아센트

관련 항목:

getMaxAscent()

getDescent

public int getDescent()

이 FontMetrics 오브젝트가 기술하는 Font 의 「폰트 디 센트」를 판정합니다. 폰트 디 센트는 폰트의 baseline로부터 디센더를 가지는 대부분의 영숫자의 하단까지의 거리입니다. Font 의 캐릭터에 따라서는 폰트의 디 센트 라인으로부터 초과하는 경우가 있습니다.

반환값:

Font 의 폰트 디 센트

관련 항목:

getMaxDescent()

getHeight

public int getHeight()

이 폰트의 텍스트 1 행의 표준의 높이를 취득합니다. 이것은 인접하는 텍스트행의 baseline의 사이의 거리입니다. 이 거리는 leading, 아센트, 및 디 센트의 합계치입니다. 둥근 관계로, 이 값은 getAscent(), getDescent(), getLeading()의 합계와 일치하지 않는 것이 있습니다. 다만, 이 거리 간격으로 자리매김되는 텍스트행이 서로 떨어져 있다고는 프로텍션되고 있지 않습니다. 예를 들어, 어느 캐릭터가 표준 아센트메트릭스 또는 표준 디센트메트릭스의 어느 쪽인지를 넘고 있는 경우, 행이 오버랩 하는 일이 있습니다.

반환값:

폰트의 표준 높이

관련 항목:

getLeading() , getAscent() , getDescent()

getMaxAscent

public int getMaxAscent()

이 FontMetrics 오브젝트가 기술하는 Font 의 최대 아센트를 판정합니다. 캐릭터가 이 높이로부터 초과할 것은 없습니다.

반환값:

Font 의 캐릭터의 최대 아센트

관련 항목:

getAscent()

getMaxDescent

public int getMaxDescent()

이 FontMetrics 오브젝트가 기술하는 Font 의 최대 디 센트를 판정합니다. 캐릭터가 이 높이로부터 초과할 것은 없습니다.

반환값:

Font 의 캐릭터의 최대 디 센트

관련 항목:

getDescent()

getMaxDecent

public int getMaxDecent()

추천 되고 있지 않습니다. JDK 버젼 1.1. 1 이후는 getMaxDescent() 를 사용

하위 호환성 (을) 위해서만 준비되어 있습니다.

반환값:

Font 의 캐릭터의 최대 디 센트

관련 항목:

getMaxDescent()

getMaxAdvance

public int getMaxAdvance()

이 Font 의 캐릭터의 최대 유효폭을 돌려줍니다. 유효폭은 캐릭터 라인의 baseline의 좌단의 점으로부터 우단의 점까지의 거리입니다. 유효 String 는 반드시 캐릭터의 유효치의 합계가 아닙니다.

반환값:

Font 의 임의의 캐릭터의 최대 유효폭. 최대 유효폭을 모르는 경우는 -1

charWidth

public int charWidth(int ch)

이 Font 의 지정한 캐릭터의 유효폭을 돌려줍니다. 유효폭은 캐릭터 라인의 baseline의 좌단의 점으로부터 우단의 점까지의 거리입니다. 유효 String 는 반드시 캐릭터의 유효폭의 합계는 아닌 것에 주의해 주세요.

파라미터:

ch - 측정 대상의 캐릭터

반환값:

이 FontMetrics 오브젝트가 기술하는 Font 의 지정된 char 의 유효폭

관련 항목:

charsWidth(char[], int, int) , stringWidth(String)

charWidth

public int charWidth(char ch)

이 Font 의 지정한 캐릭터의 유효폭을 돌려줍니다. 유효폭은 캐릭터 라인의 baseline의 좌단의 점으로부터 우단의 점까지의 거리입니다. 유효 String 는 반드시 캐릭터의 유효폭의 합계는 아닌 것에 주의해 주세요.

파라미터:

ch - 측정 대상의 캐릭터

반환값:

이 FontMetrics 오브젝트가 기술하는 Font 의 지정된 char 의 유효폭

관련 항목:

charsWidth(char[], int, int) , stringWidth(String)

stringWidth

public int stringWidth(String  str)

지정된 String 를, 이 Font 로 표시하기 위한 유효폭의 합계를 돌려줍니다. 유효폭이란, 캐릭터 라인의 baseline상의 좌단의 점으로부터 우단의 점까지의 거리입니다.

이 메소드로 돌려주어지는 유효폭의 합계는 표현 문맥을 고려하고 있지 않는 것에 주의해 주세요. 따라서, 에일리어징 제거 및 부분 메트릭스힌트가 유효폭에 영향을 주는 일이 있습니다. 에일리어징 제거 및 부분 메트릭스힌트를 유효하게 하려면 , 이 메소드는 아니고 getStringBounds (String, Graphics) 를 사용해 주세요. 유효 String 는 반드시 캐릭터의 유효치의 합계가 아닙니다.

파라미터:

str - 측정되는 String

반환값:

이 FontMetrics 가 기술하는 Font 의 지정된 String 의 유효폭

관련 항목:

bytesWidth(byte[], int, int) , charsWidth(char[], int, int) , getStringBounds(String, Graphics)

charsWidth

public int charsWidth(char[] data,
                      int off,
                      int len)

지정된 캐릭터 배열을 이 Font 로 표시하기 위한 유효폭의 합계를 돌려줍니다. 유효폭은 캐릭터 라인의 baseline의 좌단의 점으로부터 우단의 점까지의 거리입니다. 유효 String 는 반드시 캐릭터의 유효폭의 합계가 아닙니다. 지정한 범위에서 캐릭터의 String 를 측정하는 경우와 같은 결과를 얻을 수 있습니다.

파라미터:

data - 측정되는 캐릭터의 배열

off - 배열중의 캐릭터의 개시 오프셋(offset)

len - 배열로부터 측정되는 캐릭터수

반환값:

이 FontMetrics 오브젝트가 기술하는 폰트의 지정된 char 배열의 부분 배열의 유효폭

관련 항목:

charWidth(int) , charWidth(char) , bytesWidth(byte[], int, int) , stringWidth(String)

bytesWidth

public int bytesWidth(byte[] data,
                      int off,
                      int len)

지정된 캐릭터 배열을 이 Font 로 표시하기 위한 유효폭의 합계를 돌려줍니다. 유효폭은 캐릭터 라인의 baseline의 좌단의 점으로부터 우단의 점까지의 거리입니다. 유효 String 는 반드시 캐릭터의 유효폭의 합계가 아닙니다. 지정한 범위에서 캐릭터의 String 를 측정하는 경우와 같은 결과를 얻을 수 있습니다.

파라미터:

data - 측정되는 바이트의 배열

off - 배열중의 바이트의 개시 오프셋(offset)

len - 배열로부터 측정되는 바이트수

반환값:

이 FontMetrics 오브젝트가 기술하는 Font 의 지정된 byte 배열의 부분 배열의 유효폭

관련 항목:

charsWidth(char[], int, int) , stringWidth(String)

getWidths

public int[] getWidths()

이 Font 의 최초의 256 캐릭터의 유효폭을 취득합니다. 유효폭은 캐릭터 라인의 baseline의 좌단의 점으로부터 우단의 점까지의 거리입니다. 유효 String 는 반드시 캐릭터의 유효폭의 합계는 아닌 것에 주의해 주세요.

반환값:

이 FontMetrics 오브젝트가 기술하는 Font 의 캐릭터의 유효폭이 저장되고 있는 배열

hasUniformLineMetrics

public boolean hasUniformLineMetrics()

Font 가 균일의 라인메트릭스를 가질지 어떨지를 판정합니다. 복합 폰트는 다양한 캐릭터 세트를 망라하기 위해서 복수의 폰트로 구성되는 일이 있습니다. 그 경우,FontLineMetrics 오브젝트는 균일하지는 않습니다. 폰트 마다, 다른 아센트, 디 센트, 메트릭스등을 가지는 일이 있습니다. 이 정보는 행 측정 및 행 분할에 필요하게 되는 경우가 있습니다.

반환값:

폰트가 균일의 라인메트릭스를 가지는 경우는 true, 그렇지 않은 경우는 false

관련 항목:

Font.hasUniformLineMetrics()

getLineMetrics

public LineMetrics  getLineMetrics(String  str,
                                  Graphics  context)

지정된 Graphics 문맥으로, 지정된 String 의 LineMetrics 오브젝트를 돌려줍니다.

파라미터:

str - 지정된 String

context - 지정된 Graphics 문맥

반환값:

지정된 String 및 Graphics 문맥으로 생성된 LineMetrics 오브젝트

관련 항목:

Font.getLineMetrics(String, FontRenderContext)

getLineMetrics

public LineMetrics  getLineMetrics(String  str,
                                  int beginIndex,
                                  int limit,
                                  Graphics  context)

지정된 Graphics 문맥으로, 지정된 String 의 LineMetrics 오브젝트를 돌려줍니다.

파라미터:

str - 지정된 String

beginIndex - str 의 개시 오프셋(offset)

limit - str 의 길이

context - 지정된 Graphics 문맥

반환값:

지정된 String 및 Graphics 문맥으로 생성된 LineMetrics 오브젝트

관련 항목:

Font.getLineMetrics(String, int, int, FontRenderContext)

getLineMetrics

public LineMetrics  getLineMetrics(char[] chars,
                                  int beginIndex,
                                  int limit,
                                  Graphics  context)

지정된 Graphics 문맥으로, 지정된 캐릭터 배열의 LineMetrics 오브젝트를 돌려줍니다.

파라미터:

chars - 지정된 캐릭터 배열

beginIndex - chars 의 개시 오프셋(offset)

limit - chars 의 길이

context - 지정된 Graphics 문맥

반환값:

지정된 캐릭터 배열 및 Graphics 문맥으로 작성된 LineMetrics 오브젝트

관련 항목:

Font.getLineMetrics(char[], int, int, FontRenderContext)

getLineMetrics

public LineMetrics  getLineMetrics(CharacterIterator  ci,
                                  int beginIndex,
                                  int limit,
                                  Graphics  context)

지정된 Graphics 문맥으로, 지정된 CharacterIterator 의 LineMetrics 오브젝트를 돌려줍니다.

파라미터:

ci - 지정된 CharacterIterator

beginIndex - ci 의 개시 오프셋(offset)

limit - ci 의 종료 인덱스

context - 지정된 Graphics 문맥

반환값:

지정된 인수로 생성된 LineMetrics 오브젝트

관련 항목:

Font.getLineMetrics(CharacterIterator, int, int, FontRenderContext)

getStringBounds

public Rectangle2D  getStringBounds(String  str,
                                   Graphics  context)

지정된 Graphics 문맥으로, 지정된 String 의 경계를 돌려줍니다. 이 경계는 String 를 배치하기 위해서 사용됩니다.

파라미터:

str - 지정된 String

context - 지정된 Graphics 문맥

반환값:

지정된 Graphics 문맥을 가져, 지정된 String 의 바운딘그복스를 나타내는

관련 항목:

Font.getStringBounds(String, FontRenderContext)

getStringBounds

public Rectangle2D  getStringBounds(String  str,
                                   int beginIndex,
                                   int limit,
                                   Graphics  context)

지정된 Graphics 문맥으로, 지정된 String 의 경계를 돌려줍니다. 이 경계는 String 를 배치하기 위해서 사용됩니다.

파라미터:

str - 지정된 String

beginIndex - str 의 선두의 오프셋(offset)

limit - str 의 길이

context - 지정된 Graphics 문맥

반환값:

지정된 Graphics 문맥을 가져, 지정된 String 의 바운딘그복스를 나타내는 Rectangle2D

관련 항목:

Font.getStringBounds(String, int, int, FontRenderContext)

getStringBounds

public Rectangle2D  getStringBounds(char[] chars,
                                   int beginIndex,
                                   int limit,
                                   Graphics  context)

지정된 Graphics 문맥으로, 지정된 캐릭터 배열의 경계를 돌려줍니다. 이 경계는 지정된 캐릭터 배열,beginIndex, 및 limit 로 작성된 String 를 배치하기 위해서 사용됩니다.

파라미터:

chars - 캐릭터 배열

beginIndex - 캐릭터 배열의 초기 오프셋(offset)

limit - 캐릭터 배열의 길이

context - 지정된 Graphics 문맥

반환값:

지정된 Graphics 문맥을 가져, 지정된 캐릭터 배열의 바운딘그복스를 나타내는 Rectangle2D

관련 항목:

Font.getStringBounds(char[], int, int, FontRenderContext)

getStringBounds

public Rectangle2D  getStringBounds(CharacterIterator  ci,
                                   int beginIndex,
                                   int limit,
                                   Graphics  context)

지정된 Graphics 문맥으로, 지정된 CharacterIterator 내의 인덱스 첨부 캐릭터 라인의 경계를 돌려줍니다.

파라미터:

ci - 지정된 CharacterIterator

beginIndex - ci 의 개시 오프셋(offset)

limit - ci 의 종료 인덱스

context - 지정된 Graphics 문맥

반환값:

지정된 Graphics 문맥을 가져, 지정된 CharacterIterator 내의 인덱스 첨부 캐릭터의 바운딘그복스를 나타내는 Rectangle2D

관련 항목:

Font.getStringBounds(CharacterIterator, int, int, FontRenderContext)

getMaxCharBounds

public Rectangle2D  getMaxCharBounds(Graphics  context)

지정된 Graphics 문맥으로, 최대의 경계를 가지는 캐릭터의 경계를 돌려줍니다.

파라미터:

context - 지정된 Graphics 문맥

반환값:

최대의 경계를 가지는 캐릭터의 바운딘그복스를 나타내는 Rectangle2D

관련 항목:

Font.getMaxCharBounds(FontRenderContext)

toString

public String  toString()

이 FontMetrics 오브젝트의 값의 String 표현을 돌려줍니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 FontMetrics 오브젝트의 String 표현

도입된 버젼:

JDK1. 0.