FontMetrics (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

java.awt
클래스 FontMetrics

java.lang.Object 
  java.awt.FontMetrics

모든 구현된 인터페이스:: Serializable

public abstract class FontMetrics
extends Object
implements Serializable
extends Object
implements Serializable

FontMetrics 클래스는 특정의 화면에서의 특정의 폰트에 관한 렌더링 정보를 캡슐화하는 폰트 시학 객체를 정의합니다.

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

문자 「p」은 그 참조점을 나타내는 이 클래스의 각 메서드에서의 구현은 효율적은 아니기 때문에 일반적으로 보다 효율적인 툴 킷 특유의 구현으로 오버라이드(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` 특정의 문자 그래프를 조사하기 위한 새로운 `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 codePoint)` 이 `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 특정의 문자 그래프를 조사하기 위한 새로운 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

@Deprecated 
public int getMaxDecent()

추천하지 않습니다. JDK 버전 1.1. 1 그 뒤로는 getMaxDescent()를 사용합니다.

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

반환값:: Font 문자의 최대 디 센트
관련 항목:: getMaxDescent()

getMaxAdvance

public int getMaxAdvance()

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

반환값:: Font 임의의 문자의 최대 유효폭. 최대 유효넓이를 모르는 경우는 -1

charWidth

public int charWidth(int codePoint)

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

이 메서드는 지정된 문자가 유효한 Unicode 코드 포인트일지 어떨지를 검증하지 않습니다. 호출측에서 필요에 따라서 Character.isValidCodePoint를 사용해, 문자치를 검증할 필요가 있습니다.

파라미터:: codePoint - 측정하는 문자 (Unicode 코드 포인트)
반환값:: 이 FontMetrics 객체가 기술하는 Font 지정된 문자의 유효폭
관련 항목:: charsWidth(char[], int, int), stringWidth(String)

charWidth

public int charWidth(char ch)

주: 이 메서드는보조 문자를 처리할 수 없습니다. 보조 문자를 포함한 모든 Unicode 문자를 지원하려면, charWidth(int) 메서드를 사용합니다.

파라미터:: ch - 측정 대상의 문자
반환값:: 이 FontMetrics 객체가 기술하는 Font 지정된 문자의 유효폭
관련 항목:: 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)

파라미터:: 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 바운딩박스를 나타내는 Rectangle2D
관련 항목:: 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.

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor | 메서드

상세: 필드 | 생성자 | 메서드

java.awt 클래스 FontMetrics

font

FontMetrics

getFont

getLeading

getAscent

getDescent

getHeight

getMaxAscent

getMaxDescent

getMaxDecent

getMaxAdvance

charWidth

charWidth

stringWidth

charsWidth

bytesWidth

getWidths

hasUniformLineMetrics

getLineMetrics

getLineMetrics

getLineMetrics

getLineMetrics

getStringBounds

getStringBounds

getStringBounds

getStringBounds

getMaxCharBounds

toString

java.awt
클래스 FontMetrics