FontMetrics (Платформа Java SE 7)

java.lang. Объект
- java.awt. FontMetrics

Все Реализованные Интерфейсы:

Сериализуемый
```
public abstract class FontMetrics
extends Object
implements Serializable
```
FontMetrics класс определяет объект метрик шрифта, который инкапсулирует информацию о рендеринге определенного шрифта на определенном экране.
Отметьте подклассификаторам: Так как многие из этих методов форма закрылись, взаимно рекурсивные циклы, следует заботиться, что Вы реализуете по крайней мере один из методов в каждом таком цикле, чтобы предотвратить бесконечную рекурсию, когда Ваш подкласс используется. В частности следующее является минимальным предложенным набором методов, чтобы переопределить, чтобы гарантировать правильность и предотвратить бесконечную рекурсию (хотя другие подмножества одинаково выполнимы):
Отметьте, что реализации этих методов неэффективны, таким образом, они обычно переопределяются с более эффективными специфичными для инструментария реализациями.
Когда приложение просит помещать символ в позицию (x, y), символ помещается так, чтобы его контрольная точка (показанный как точка в сопроводительном изображении) была помещена в ту позицию. Контрольная точка определяет горизонтальную строку, названную базовой линией символа. В нормальной печати должны выровняться базовые линии символов.
Кроме того, у каждого символа в шрифте есть подъем, спуск, и ширина усовершенствования. Подъем является количеством, которым символ возрастает выше базовой линии. Спуск является количеством, которым символ убывает ниже базовой линии. Ширина усовершенствования указывает на позицию, в которую AWT должен поместить следующий символ.
У массива символов или строки могут также быть подъем, спуск, и ширина усовершенствования. Подъем массива является максимальным подъемом любого символа в массиве. Спуск является максимальным спуском любого символа в массиве. Ширина усовершенствования является суммой ширин усовершенствования каждого из символов в символьном массиве. Усовершенствование a String расстояние вдоль базовой линии String. Это расстояние является шириной, которая должна использоваться для центрирования или выравнивания по правому краю String.
Отметьте что усовершенствование a String не обязательно сумма усовершенствований ее символов, измеренных в изоляции, потому что ширина символа может измениться в зависимости от ее контекста. Например, в арабском тексте, форма символа может измениться, чтобы соединиться с другими символами. Кроме того, в некоторых сценариях определенные символьные последовательности могут быть представлены единственной формой, названной лигатурой. Измерение символов индивидуально не учитывает эти преобразования.
Метрики шрифта базово-относительны, означая, что они обычно независимы от вращения, которому применяются к шрифт (возможная сетка по модулю, подсказывающая эффекты). См. Font.
С тех пор:

JDK1.0

См. Также:
Font, Сериализированная Форма

Полевая Сводка

Поля
Модификатор и Тип	Поле и Описание
`protected Font`	`шрифт` Фактическое `Font` из которого создаются метрики шрифта.

Сводка конструктора

Конструкторы
Модификатор	Конструктор и Описание
`protected`	`FontMetrics(Font font)` Создает новое `FontMetrics` объект для того, чтобы узнать информацию о высоте и ширине об указанном `Font` и определенные символьные глифы в этом `Font`.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`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()` Определяет подъем шрифта `Font` описанный этим `FontMetrics` объект.
`int`	`getDescent()` Определяет спуск шрифта `Font` описанный этим `FontMetrics` объект.
`Шрифт`	`getFont()` Добирается `Font` описанный этим `FontMetrics` объект.
`FontRenderContext`	`getFontRenderContext()` Добирается `FontRenderContext` используемый этим `FontMetrics` возразите, чтобы измерить текст.
`int`	`getHeight()` Получает стандартную высоту строки текста в этом шрифте.
`int`	`getLeading()` Определяет стандартное продвижение `Font` описанный этим `FontMetrics` объект.
`LineMetrics`	`getLineMetrics(char[] chars, int beginIndex, int limit, Graphics context)` Возвраты `LineMetrics` объект для указанного символьного массива в указанном `Graphics` контекст.
`LineMetrics`	`getLineMetrics(CharacterIterator ci, int beginIndex, int limit, Graphics context)` Возвраты `LineMetrics` объект для указанного `CharacterIterator` в указанном `Graphics` контекст.
`LineMetrics`	`getLineMetrics(String str, Graphics context)` Возвраты `LineMetrics` объект для указанного `String` в указанном `Graphics` контекст.
`LineMetrics`	`getLineMetrics(String str, int beginIndex, int limit, Graphics context)` Возвраты `LineMetrics` объект для указанного `String` в указанном `Graphics` контекст.
`int`	`getMaxAdvance()` Получает максимальную ширину усовершенствования любого символа в этом `Font`.
`int`	`getMaxAscent()` Определяет максимальный подъем `Font` описанный этим `FontMetrics` объект.
`Rectangle2D`	`getMaxCharBounds(Graphics context)` Возвращает границы для символа с максимальными границами в указанном `Graphics` контекст.
`int`	`getMaxDecent()` Осуждаемый. С версии 1.1.1 JDK, замененной `getMaxDescent()`.
`int`	`getMaxDescent()` Определяет максимальный спуск `Font` описанный этим `FontMetrics` объект.
`Rectangle2D`	`getStringBounds(char[] chars, int beginIndex, int limit, Graphics context)` Возвращает границы указанного массива символов в указанном `Graphics` контекст.
`Rectangle2D`	`getStringBounds(CharacterIterator ci, int beginIndex, int limit, Graphics context)` Возвращает границы символов, индексированных в указанном `CharacterIterator` в указанном `Graphics` контекст.
`Rectangle2D`	`getStringBounds(String str, Graphics context)` Возвращает границы указанного `String` в указанном `Graphics` контекст.
`Rectangle2D`	`getStringBounds(String str, int beginIndex, int limit, Graphics context)` Возвращает границы указанного `String` в указанном `Graphics` контекст.
`int[]`	`getWidths()` Получает ширины усовершенствования первых 256 символов в `Font`.
`boolean`	`hasUniformLineMetrics()` Проверки, чтобы видеть, если `Font` имеет универсальные метрики строки.
`int`	`stringWidth(String str)` Возвращает полную ширину усовершенствования для того, чтобы показать указанное `String` в этом `Font`.
`Строка`	`toString()` Возвращает представление этого `FontMetrics` значения объекта как a `String`.

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Полевая Деталь
  - шрифт
```
protected Font font
```
    Фактическое Font из которого создаются метрики шрифта. Это не может быть нулем.
    
    См. Также:
    getFont()
- Деталь конструктора
  - FontMetrics
```
protected FontMetrics(Font font)
```
    Создает новое FontMetrics объект для того, чтобы узнать информацию о высоте и ширине об указанном Font и определенные символьные глифы в этом Font.
    
    Параметры:
    font - Font
    См. Также:
    Font
- Деталь метода
  - getFont
```
public Font getFont()
```
    Добирается Font описанный этим FontMetrics объект.
    
    Возвраты:
    Font описанный этим FontMetrics объект.
  - getFontRenderContext
```
public FontRenderContext getFontRenderContext()
```
    Добирается FontRenderContext используемый этим FontMetrics возразите, чтобы измерить текст.
    Отметьте, что методы в этом классе, которые берут a Graphics текст меры по параметру, используя FontRenderContext из этого Graphics объект, и не это FontRenderContext
    
    Возвраты:
    FontRenderContext используемый этим FontMetrics объект.
    С тех пор:
    
    1.6
  - getLeading
```
public int getLeading()
```
    Определяет стандартное продвижение Font описанный этим FontMetrics объект. Стандартное продвижение, или интервал шпона, является логическим количеством пространства, которое будет зарезервировано между спуском одной строки текста и подъемом следующей строки. Метрика высоты вычисляется, чтобы включать это дополнительное пространство.
    
    Возвраты:
    стандартное продвижение Font.
    См. Также:
    getHeight(), getAscent(), getDescent()
  - getAscent
```
public int getAscent()
```
    Определяет подъем шрифта Font описанный этим FontMetrics объект. Подъем шрифта является расстоянием от базовой линии шрифта до вершины большинства алфавитно-цифровых символов. Некоторые символы в Font мог бы расшириться выше строки подъема шрифта.
    
    Возвраты:
    подъем шрифта Font.
    См. Также:
    getMaxAscent()
  - getDescent
```
public int getDescent()
```
    Определяет спуск шрифта Font описанный этим FontMetrics объект. Спуск шрифта является расстоянием от базовой линии шрифта до нижней части большинства алфавитно-цифровых символов с подстрочными элементами. Некоторые символы в Font мог бы расшириться ниже строки спуска шрифта.
    
    Возвраты:
    спуск шрифта Font.
    См. Также:
    getMaxDescent()
  - getHeight
```
public int getHeight()
```
    Получает стандартную высоту строки текста в этом шрифте. Это - расстояние между базовой линией смежных строк текста. Это - сумма продвижения + подъем + спуск. Из-за округления этого, возможно, не то же самое как getAscent () + getDescent () + getLeading (). Нет никакой гарантии, что строки текста, расположенного с интервалами на этом расстоянии, являются непересекающимися; такие строки могут наложиться, если некоторые символы промахиваются или по стандартному подъему или по стандартной метрике спуска.
    
    Возвраты:
    стандартная высота шрифта.
    См. Также:
    getLeading(), getAscent(), getDescent()
  - getMaxAscent
```
public int getMaxAscent()
```
    Определяет максимальный подъем Font описанный этим FontMetrics объект. Никакой символ не расширяется далее выше базовой линии шрифта чем эта высота.
    
    Возвраты:
    максимальный подъем любого символа в Font.
    См. Также:
    getAscent()
  - getMaxDescent
```
public int getMaxDescent()
```
    Определяет максимальный спуск Font описанный этим FontMetrics объект. Никакой символ не расширяется далее ниже базовой линии шрифта чем эта высота.
    
    Возвраты:
    максимальный спуск любого символа в Font.
    См. Также:
    getDescent()
  - getMaxDecent
```
@Deprecated
public int getMaxDecent()
```
    Осуждаемый. С версии 1.1.1 JDK, замененной getMaxDescent().
    
    Для обратной совместимости только.
    
    Возвраты:
    максимальный спуск любого символа в Font.
    См. Также:
    getMaxDescent()
  - getMaxAdvance
```
public int getMaxAdvance()
```
    Получает максимальную ширину усовершенствования любого символа в этом Font. Усовершенствование является расстоянием от крайней левой точки до самой правой точки на базовой линии строки. Усовершенствование a String не обязательно сумма усовершенствований ее символов.
    
    Возвраты:
    максимальная ширина усовершенствования любого символа в Font, или -1 если максимальная ширина усовершенствования не известна.
  - charWidth
```
public int charWidth(int codePoint)
```
    Возвращает ширину усовершенствования указанного символа в этом Font. Усовершенствование является расстоянием от крайней левой точки до самой правой точки на базовой линии символа. Отметьте что усовершенствование a String не обязательно сумма усовершенствований ее символов.
    Этот метод не проверяет указанного символа, чтобы быть допустимой кодовой точкой Unicode. Вызывающая сторона должна проверить символьного использования значения Character.isValidCodePoint в случае необходимости.
    
    Параметры:
    codePoint - символ (кодовая точка Unicode), чтобы быть измеренным
    
    Возвраты:
    ширина усовершенствования указанного символа в Font описанный этим FontMetrics объект.
    См. Также:
    charsWidth(char[], int, int), stringWidth(String)
  - charWidth
```
public int charWidth(char ch)
```
    Возвращает ширину усовершенствования указанного символа в этом Font. Усовершенствование является расстоянием от крайней левой точки до самой правой точки на базовой линии символа. Отметьте что усовершенствование a String не обязательно сумма усовершенствований ее символов.
    Отметьте: Этот метод не может обработать дополнительные символы. Поддерживать все символы Unicode, включая дополнительные символы, использование charWidth(int) метод.
    
    Параметры:
    ch - символ, который будет измерен
    
    Возвраты:
    ширина усовершенствования указанного символа в Font описанный этим FontMetrics объект.
    См. Также:
    charsWidth(char[], int, int), stringWidth(String)
  - stringWidth
```
public int stringWidth(String str)
```
    Возвращает полную ширину усовершенствования для того, чтобы показать указанное String в этом Font. Усовершенствование является расстоянием от крайней левой точки до самой правой точки на базовой линии строки.
    Отметьте что усовершенствование a String не обязательно сумма усовершенствований ее символов.
    
    Параметры:
    str - String быть измеренным
    
    Возвраты:
    ширина усовершенствования указанного String в Font описанный этим FontMetrics.
    
    Броски:
    
    NullPointerException - если str является нулем.
    См. Также:
    bytesWidth(byte[], int, int), charsWidth(char[], int, int), getStringBounds(String, Graphics)
  - charsWidth
```
public int charsWidth(char[] data,
             int off,
             int len)
```
    Возвращает полную ширину усовершенствования для того, чтобы показать указанный массив символов в этом Font. Усовершенствование является расстоянием от крайней левой точки до самой правой точки на базовой линии строки. Усовершенствование a String не обязательно сумма усовершенствований ее символов. Это эквивалентно измерению a String из символов в указанном диапазоне.
    
    Параметры:
    data - массив символов, которые будут измерены
    off - смещение запуска символов в массиве
    len - число символов, которые будут измерены от массива
    
    Возвраты:
    ширина усовершенствования подмассива указанного char массив в шрифте описывается этим FontMetrics объект.
    
    Броски:
    
    NullPointerException - если data нуль.
    
    IndexOutOfBoundsException - если off и len параметры индексируют символы вне границ data массив.
    См. Также:
    charWidth(int), charWidth(char), bytesWidth(byte[], int, int), stringWidth(String)
  - bytesWidth
```
public int bytesWidth(byte[] data,
             int off,
             int len)
```
    Возвращает полную ширину усовершенствования для того, чтобы показать указанный массив байтов в этом Font. Усовершенствование является расстоянием от крайней левой точки до самой правой точки на базовой линии строки. Усовершенствование a String не обязательно сумма усовершенствований ее символов. Это эквивалентно измерению a String из символов в указанном диапазоне.
    
    Параметры:
    data - массив байтов, которые будут измерены
    off - смещение запуска байтов в массиве
    len - число байтов, которые будут измерены от массива
    
    Возвраты:
    ширина усовершенствования подмассива указанного byte массив в Font описанный этим FontMetrics объект.
    
    Броски:
    
    NullPointerException - если data нуль.
    
    IndexOutOfBoundsException - если off и len параметры индексируют байты вне границ data массив.
    См. Также:
    charsWidth(char[], int, int), stringWidth(String)
  - getWidths
```
public int[] getWidths()
```
    Получает ширины усовершенствования первых 256 символов в Font. Усовершенствование является расстоянием от крайней левой точки до самой правой точки на базовой линии символа. Отметьте что усовершенствование a String не обязательно сумма усовершенствований ее символов.
    
    Возвраты:
    массив, хранящий ширины усовершенствования символов в Font описанный этим FontMetrics объект.
  - hasUniformLineMetrics
```
public boolean hasUniformLineMetrics()
```
    Проверки, чтобы видеть, если Font имеет универсальные метрики строки. Составной шрифт может состоять из нескольких различных шрифтов, чтобы покрыть различные наборы символов. В таких случаях, FontLineMetrics объекты не универсальны. У различных шрифтов могут быть различный подъем, спуск, метрики и так далее. Эта информация иногда необходима для измерения строки и повреждения строки.
    
    Возвраты:
    true если у шрифта есть универсальные метрики строки; false иначе.
    См. Также:
    Font.hasUniformLineMetrics()
  - getLineMetrics
```
public LineMetrics getLineMetrics(String str,
                         Graphics context)
```
    Возвраты LineMetrics объект для указанного String в указанном Graphics контекст.
    
    Параметры:
    str - указанное String
    context - указанное Graphics контекст
    
    Возвраты:
    a LineMetrics объект создается с указанным String и Graphics контекст.
    См. Также:
    Font.getLineMetrics(String, FontRenderContext)
  - getLineMetrics
```
public LineMetrics getLineMetrics(String str,
                         int beginIndex,
                         int limit,
                         Graphics context)
```
    Возвраты LineMetrics объект для указанного String в указанном Graphics контекст.
    
    Параметры:
    str - указанное String
    beginIndex - начальное смещение str
    limit - смещение конца str
    context - указанное Graphics контекст
    
    Возвраты:
    a LineMetrics объект создается с указанным String и Graphics контекст.
    См. Также:
    Font.getLineMetrics(String, int, int, FontRenderContext)
  - getLineMetrics
```
public LineMetrics getLineMetrics(char[] chars,
                         int beginIndex,
                         int limit,
                         Graphics context)
```
    Возвраты LineMetrics объект для указанного символьного массива в указанном Graphics контекст.
    
    Параметры:
    chars - указанный символьный массив
    beginIndex - начальное смещение chars
    limit - смещение конца chars
    context - указанное Graphics контекст
    
    Возвраты:
    a LineMetrics объект, создаваемый с указанным символьным массивом и Graphics контекст.
    См. Также:
    Font.getLineMetrics(char[], int, int, FontRenderContext)
  - getLineMetrics
```
public LineMetrics getLineMetrics(CharacterIterator ci,
                         int beginIndex,
                         int limit,
                         Graphics context)
```
    Возвраты LineMetrics объект для указанного CharacterIterator в указанном Graphics контекст.
    
    Параметры:
    ci - указанное CharacterIterator
    beginIndex - начальное смещение в ci
    limit - индекс конца ci
    context - указанное Graphics контекст
    
    Возвраты:
    a LineMetrics объект создается с указанными параметрами.
    См. Также:
    Font.getLineMetrics(CharacterIterator, int, int, FontRenderContext)
  - getStringBounds
```
public Rectangle2D getStringBounds(String str,
                          Graphics context)
```
    Возвращает границы указанного String в указанном Graphics контекст. Границы привыкли к расположению String.
    Отметьте: возвращенные границы находятся в базово-относительных координатах (см. class notes).
    
    Параметры:
    str - указанное String
    context - указанное Graphics контекст
    
    Возвраты:
    a Rectangle2D это - ограничивающий прямоугольник указанного String в указанном Graphics контекст.
    См. Также:
    Font.getStringBounds(String, FontRenderContext)
  - getStringBounds
```
public Rectangle2D getStringBounds(String str,
                          int beginIndex,
                          int limit,
                          Graphics context)
```
    Возвращает границы указанного String в указанном Graphics контекст. Границы привыкли к расположению String.
    Отметьте: возвращенные границы находятся в базово-относительных координатах (см. class notes).
    
    Параметры:
    str - указанное String
    beginIndex - смещение начала str
    limit - смещение конца str
    context - указанное Graphics контекст
    
    Возвраты:
    a Rectangle2D это - ограничивающий прямоугольник указанного String в указанном Graphics контекст.
    См. Также:
    Font.getStringBounds(String, int, int, FontRenderContext)
  - getStringBounds
```
public Rectangle2D getStringBounds(char[] chars,
                          int beginIndex,
                          int limit,
                          Graphics context)
```
    Возвращает границы указанного массива символов в указанном Graphics контекст. Границы привыкли к расположению String создаваемый с указанным массивом символов, beginIndex и limit.
    Отметьте: возвращенные границы находятся в базово-относительных координатах (см. class notes).
    
    Параметры:
    chars - массив символов
    beginIndex - начальное смещение массива символов
    limit - смещение конца массива символов
    context - указанное Graphics контекст
    
    Возвраты:
    a Rectangle2D это - ограничивающий прямоугольник указанного символьного массива в указанном Graphics контекст.
    См. Также:
    Font.getStringBounds(char[], int, int, FontRenderContext)
  - getStringBounds
```
public Rectangle2D getStringBounds(CharacterIterator ci,
                          int beginIndex,
                          int limit,
                          Graphics context)
```
    Возвращает границы символов, индексированных в указанном CharacterIterator в указанном Graphics контекст.
    Отметьте: возвращенные границы находятся в базово-относительных координатах (см. class notes).
    
    Параметры:
    ci - указанное CharacterIterator
    beginIndex - начальное смещение в ci
    limit - индекс конца ci
    context - указанное Graphics контекст
    
    Возвраты:
    a Rectangle2D это - ограничивающий прямоугольник символов, индексированных в указанном CharacterIterator в указанном Graphics контекст.
    См. Также:
    Font.getStringBounds(CharacterIterator, int, int, FontRenderContext)
  - getMaxCharBounds
```
public Rectangle2D getMaxCharBounds(Graphics context)
```
    Возвращает границы для символа с максимальными границами в указанном Graphics контекст.
    
    Параметры:
    context - указанное Graphics контекст
    
    Возвраты:
    a Rectangle2D это - ограничивающий прямоугольник для символа с максимальными границами.
    См. Также:
    Font.getMaxCharBounds(FontRenderContext)
  - toString
```
public String toString()
```
    Возвращает представление этого FontMetrics значения объекта как a String.
    
    Переопределения:
    
    toString в классе Object
    
    Возвраты:
    a String представление этого FontMetrics объект.
    С тех пор:
    
    JDK1.0.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс FontMetrics

Полевая Сводка

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Объект

Полевая Деталь

шрифт

Деталь конструктора

FontMetrics

Деталь метода

getFont

getFontRenderContext

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