Spec-Zone .ru
спецификации, руководства, описания, API
|
public class Font extends Object implements Serializable
Font
class представляет шрифты, которые используются, чтобы представить текст видимым способом. Шрифт предоставляет информацию, должен был отобразить последовательности символов к последовательностям глифов и представлять последовательности глифов на Graphics
и Component
объекты. 'g'
, ЛАТИНСКИЙ Г СТРОЧНОЙ БУКВЫ, символ. Глиф является формой, используемой, чтобы представить символ или последовательность символов. В простых системах письменности, таких как латынь, обычно один глиф представляет один символ. Вообще, однако, у символов и глифов нет взаимно-однозначного соответствия. Например, символ 'á' ЛАТИНСКАЯ СТРОЧНАЯ БУКВА С ОСТРЫМ, может быть представлен двумя глифами: один для и один для '´ '. С другой стороны двухсимвольная строка "fi" может быть представлена единственным глифом, "fi" лигатурой. В сложных системах письменности, таких как арабский язык или Южные и Юго-восточные азиатские системы письменности, отношение между символами и глифами может быть более усложнено и включить контекстно-зависимый выбор переупорядочение глифа так же как глифов. Шрифт инкапсулирует набор глифов, должен был представить выбранный набор символов, так же как таблицы должны были отобразить последовательности символов к соответствующим последовательностям глифов.
Физические шрифты являются фактическими библиотеками шрифтов, содержащими данные глифа и таблицы, чтобы отобразиться от символьных последовательностей до последовательностей глифа, используя технологию шрифта, таких как Тип 1 PostScript или TrueType. Все реализации Платформы Java должны поддерживать шрифты TrueType; поддержка других технологий шрифта является зависящей от реализации. Физические шрифты могут использовать имена, такие как Helvetica, Palatino, HonMincho, или любое число других имен шрифтов. Как правило, каждый физический шрифт поддерживает только ограниченный набор систем письменности, например, только латинские символы или только японская и Основная латынь. Набор доступных физических шрифтов изменяется между конфигурациями. Приложения, которые требуют определенных шрифтов, могут связать их и инстанцировать их использующий createFont
метод.
Логические шрифты являются этими пятью семействами шрифтов, определенными платформой Java, которая должна поддерживаться любой средой выполнения Java: Засечка, SansSerif, Моноширинный, Диалоговый, и DialogInput. Эти логические шрифты не являются фактическими библиотеками шрифтов. Вместо этого логические имена шрифтов отображаются на физические шрифты средой выполнения Java. Отображение является реализацией и обычно зависимой локалью, таким образом, взгляд и метрики, обеспеченные ими, изменяются. Как правило, каждое логическое имя шрифта отображается на несколько физических шрифтов, чтобы покрыть большой спектр символов.
Компоненты AWT, с которыми взаимодействуют, такой как Label
и TextField
, может только использовать логические шрифты.
Для обсуждения относительных преимуществ и недостатков использования физических или логических шрифтов, см. документ
Font
может иметь много поверхностей, такой как тяжелые, средние, наклонные, готические и регулярные. У всех этих поверхностей есть подобный типографский проект. Есть три различных имени, которые можно получить от a Font
объект. Логическое имя шрифта является просто именем, которое использовалось, чтобы создать шрифт. Имя поверхности шрифта, или только имя шрифта для краткости является именем определенной поверхности шрифта, как Полужирный Helvetica. Фамилия является именем семейства шрифтов, которое определяет типографский проект через несколько поверхностей, как Helvetica.
Font
class представляет экземпляр поверхности шрифта от набора поверхностей шрифта, которые присутствуют в системных ресурсах хост-системы. Как примеры, Полужирные Arial и Полужирный курсив Курьера являются поверхностями шрифта. Могут быть несколько Font
объекты, связанные с поверхностью шрифта, каждый отличающийся по размеру, стилю, преобразовывает и функции шрифта.
getAllFonts
метод GraphicsEnvironment
class возвращает массив всех поверхностей шрифта, доступных в системе. Эти поверхности шрифта возвращаются как Font
объекты с размером 1, идентификационные данные преобразовывают и функции шрифта значения по умолчанию. Эти основные шрифты могут тогда использоваться, чтобы произойти новый Font
объекты с переменными размерами, стилями, преобразовывают и функции шрифта через deriveFont
методы в этом class.
Font
поддерживает больше всего TextAttribute
s. Это делает некоторые операции, такие как рендеринг подчеркнутого текста, удобного, так как не необходимо явно создать a TextLayout
объект. Атрибуты могут быть установлены на Шрифте, создавая или получая это использующий a Map
из TextAttribute
значения.
Значения некоторых TextAttributes
не сериализуемы, и поэтому пытающийся сериализировать экземпляр Font
у этого есть такие значения, не будет сериализировать их. Это означает, что Шрифт, десериализованный от такого потока, не будет сравниваться равный исходному Шрифту, который содержал несериализуемые атрибуты. Это должно очень редко излагать проблему, так как эти атрибуты обычно используются только при особых обстоятельствах и вряд ли будут сериализированы.
FOREGROUND
и BACKGROUND
использовать Paint
значения. Подкласс Color
сериализуемо, в то время как GradientPaint
и TexturePaint
не.CHAR_REPLACEMENT
использование GraphicAttribute
значения. Подклассы ShapeGraphicAttribute
и ImageGraphicAttribute
не сериализуемы.INPUT_METHOD_HIGHLIGHT
использование InputMethodHighlight
значения, которые не сериализуемы. См. InputMethodHighlight
.Paint
и GraphicAttribute
может сделать их сериализуемыми и избежать этой проблемы. Клиенты, которые используют входные выделения метода, могут преобразовать их в специфичные для платформы атрибуты для того выделения на текущей платформе и установить их на Шрифте как обходное решение.
Map
На основе конструктор и deriveFont
API игнорируют атрибут ШРИФТА, и он не сохраняется Шрифтом; помехи getFont(java.util.Map<? extends java.text.AttributedCharacterIterator.Attribute, ?>)
метод должен использоваться, если атрибут ШРИФТА мог бы присутствовать. См. TextAttribute.FONT
для получения дополнительной информации.
Несколько атрибутов вызовут дополнительные издержки рендеринга и потенциально вызовут расположение. Если a Font
имеет такие атрибуты,
метод возвратит true.hasLayoutAttributes()
Отметьте: вращения Шрифта могут заставить текстовые базовые линии быть повернутыми. Чтобы учесть эту (редкую) возможность, API шрифта определяются, чтобы возвратить метрики и взять параметры 'в базово-относительных координатах. Это отображает координату 'x' на усовершенствование вдоль базовой линии, (положительный x вперед приезжает базовая линия), и координата 'y' к расстоянию вдоль перпендикуляра к базовой линии в 'x' (положительный y составляет 90 градусов по часовой стрелке от базового вектора). API, для которых это особенно важно, вызываются как наличие 'базово-относительных координат.'
Модификатор и Тип | Поле и Описание |
---|---|
static int |
ПОЛУЖИРНЫЙ
Полужирный постоянный стиль.
|
static int |
CENTER_BASELINE
Базовая линия, используемая в идеографических сценариях как китайский, японский, и корейский язык, размечая текст.
|
static String |
ДИАЛОГОВОЕ ОКНО
Строковая константа для канонической фамилии логического шрифта "Диалоговое окно".
|
static String |
DIALOG_INPUT
Строковая константа для канонической фамилии логического шрифта "DialogInput".
|
static int |
HANGING_BASELINE
Базовая линия, используемая в Devanigiri и подобных сценариях, размечая текст.
|
static int |
КУРСИВ
Курсивный постоянный стиль.
|
static int |
LAYOUT_LEFT_TO_RIGHT
Флаг к layoutGlyphVector указание, что текст слева направо как определяется анализом Bidi.
|
static int |
LAYOUT_NO_LIMIT_CONTEXT
Флаг к layoutGlyphVector указание, что текст в массиве случайной работы после обозначенного предела не должен быть исследован.
|
static int |
LAYOUT_NO_START_CONTEXT
Флаг к layoutGlyphVector указание, что текст в массиве случайной работы перед обозначенным запуском не должен быть исследован.
|
static int |
LAYOUT_RIGHT_TO_LEFT
Флаг к layoutGlyphVector указание, что текст справа налево как определяется анализом Bidi.
|
static String |
МОНОШИРИННЫЙ
Строковая константа для канонической фамилии логического шрифта, "Моноширинного".
|
protected String |
имя
Логическое имя этого
Font , как передано конструктору. |
static int |
ПЛОСКОСТЬ
Простой постоянный стиль.
|
protected float |
размер точки
Размер точки этого
Font в float . |
static int |
ROMAN_BASELINE
Базовая линия, используемая в большинстве римских сценариев, размечая текст.
|
static String |
SANS_SERIF
Строковая константа для канонической фамилии логического шрифта "SansSerif".
|
static String |
ЗАСЕЧКА
Строковая константа для канонической фамилии логического шрифта "Засечка".
|
protected int |
размер
Размер точки этого
Font , округленный к целому числу. |
protected int |
стиль
Стиль этого
Font , как передано конструктору. |
static int |
TRUETYPE_FONT
Идентифицируйте ресурс шрифта типа TRUETYPE.
|
static int |
TYPE1_FONT
Идентифицируйте ресурс шрифта типа TYPE1.
|
Модификатор | Конструктор и Описание |
---|---|
protected |
Font(Font font)
Создает новое
Font от указанного font . |
|
Font(Map<? extends AttributedCharacterIterator.Attribute,?> attributes)
Создает новое
Font с указанными атрибутами. |
|
Font(String name, int style, int size)
Создает новое
Font с указанного имени, стиля и размера точки. |
Модификатор и Тип | Метод и Описание |
---|---|
boolean |
canDisplay(char c)
Проверки, если это
Font имеет глифа для указанного символа. |
boolean |
canDisplay(int codePoint)
Проверки, если это
Font имеет глифа для указанного символа. |
int |
canDisplayUpTo(char[] text, int start, int limit)
Указывает действительно ли это
Font может вывести на экран символы в указанном text запуск в start и окончание в limit . |
int |
canDisplayUpTo(CharacterIterator iter, int start, int limit)
Указывает действительно ли это
Font может вывести на экран текст, определенный iter запуск в start и окончание в limit . |
int |
canDisplayUpTo(String str)
Указывает действительно ли это
Font может вывести на экран указанное String . |
static Font |
createFont(int fontFormat, File fontFile)
Возвращает новое
Font использование указанного типа шрифта и указанного файла шрифта. |
static Font |
createFont(int fontFormat, InputStream fontStream)
Возвращает новое
Font использование указанного типа шрифта и входных данных. |
GlyphVector |
createGlyphVector(FontRenderContext frc, char[] chars)
Создает a
GlyphVector отображая символы на глифов, непосредственных основанный на Unicode cmap в этом Font . |
GlyphVector |
createGlyphVector(FontRenderContext frc, CharacterIterator ci)
Создает a
GlyphVector отображая указанные символы на глифов, непосредственных основанный на Unicode cmap в этом Font . |
GlyphVector |
createGlyphVector(FontRenderContext frc, int[] glyphCodes)
Создает a
GlyphVector отображая символы на глифов, непосредственных основанный на Unicode cmap в этом Font . |
GlyphVector |
createGlyphVector(FontRenderContext frc, String str)
Создает a
GlyphVector отображая символы на глифов, непосредственных основанный на Unicode cmap в этом Font . |
static Font |
decode(String str)
Возвраты
Font то, что str параметр описывает. |
Шрифт |
deriveFont(AffineTransform trans)
Создает новое
Font объект, тиражируя ток Font возразите и применение нового преобразования к этому. |
Шрифт |
deriveFont(float size)
Создает новое
Font объект, тиражируя ток Font возразите и применение нового размера к этому. |
Шрифт |
deriveFont(int style)
Создает новое
Font объект, тиражируя ток Font возразите и применение нового стиля к этому. |
Шрифт |
deriveFont(int style, AffineTransform trans)
Создает новое
Font объект, тиражируя это Font возразите и применение нового стиля и преобразуйте. |
Шрифт |
deriveFont(int style, float size)
Создает новое
Font объект, тиражируя это Font возразите и применение нового стиля и размера. |
Шрифт |
deriveFont(Map<? extends AttributedCharacterIterator.Attribute,?> attributes)
Создает новое
Font объект, тиражируя ток Font возразите и применение нового набора шрифта приписывает этому. |
boolean |
equals(Object obj)
Сравнивает это
Font возразите против указанного Object . |
Map<TextAttribute,?> |
getAttributes()
Возвращает карту атрибутов шрифта, доступных в этом
Font . |
AttributedCharacterIterator. Атрибут[] |
getAvailableAttributes()
Возвращает ключи всех атрибутов, поддерживаемых этим
Font . |
byte |
getBaselineFor(char c)
Возвращает базовую линию, подходящую для отображения этого символа.
|
Строка |
getFamily()
Возвращает фамилию этого
Font . |
Строка |
getFamily(Locale l)
Возвращает фамилию этого
Font , локализованный для указанной локали. |
static Font |
getFont(Map<? extends AttributedCharacterIterator.Attribute,?> attributes)
Возвраты a
Font приспособьте атрибутам. |
static Font |
getFont(String nm)
Возвраты a
Font объект от системного списка свойств. |
static Font |
getFont(String nm, Font font)
Получает указанное
Font от системного списка свойств. |
Строка |
getFontName()
Возвращает имя поверхности шрифта этого
Font . |
Строка |
getFontName(Locale l)
Возвращает имя поверхности шрифта
Font , локализованный для указанной локали. |
float |
getItalicAngle()
Возвращает курсивный угол этого
Font . |
LineMetrics |
getLineMetrics(char[] chars, int beginIndex, int limit, FontRenderContext frc)
Возвраты a
LineMetrics объект создается с указанными параметрами. |
LineMetrics |
getLineMetrics(CharacterIterator ci, int beginIndex, int limit, FontRenderContext frc)
Возвраты a
LineMetrics объект создается с указанными параметрами. |
LineMetrics |
getLineMetrics(String str, FontRenderContext frc)
|
LineMetrics |
getLineMetrics(String str, int beginIndex, int limit, FontRenderContext frc)
Возвраты a
LineMetrics объект создается с указанными параметрами. |
Rectangle2D |
getMaxCharBounds(FontRenderContext frc)
Возвращает границы для символа с максимальными границами как определено в указанном
FontRenderContext . |
int |
getMissingGlyphCode()
Возвращает glyphCode, который используется когда это
Font не имеет глифа для указанной unicode кодовой точки. |
Строка |
getName()
Возвращает логическое имя этого
Font . |
int |
getNumGlyphs()
Возвращает число глифов в этом
Font . |
java.awt.peer.FontPeer |
getPeer()
Осуждаемый.
Рендеринг шрифта теперь независим от платформы.
|
Строка |
getPSName()
Возвращает имя постскриптума этого
Font . |
int |
getSize()
Возвращает размер точки этого
Font , округленный к целому числу. |
float |
getSize2D()
Возвращает размер точки этого
Font в float значение. |
Rectangle2D |
getStringBounds(char[] chars, int beginIndex, int limit, FontRenderContext frc)
Возвращает логические границы указанного массива символов в указанном
FontRenderContext . |
Rectangle2D |
getStringBounds(CharacterIterator ci, int beginIndex, int limit, FontRenderContext frc)
Возвращает логические границы символов, индексированных в указанном
CharacterIterator в указанном FontRenderContext . |
Rectangle2D |
getStringBounds(String str, FontRenderContext frc)
Возвращает логические границы указанного
String в указанном FontRenderContext . |
Rectangle2D |
getStringBounds(String str, int beginIndex, int limit, FontRenderContext frc)
Возвращает логические границы указанного
String в указанном FontRenderContext . |
int |
getStyle()
Возвращает стиль этого
Font . |
AffineTransform |
getTransform()
Возвращает копию преобразования, связанного с этим
Font . |
int |
hashCode()
Возвращает хэш-код для этого
Font . |
boolean |
hasLayoutAttributes()
Возвратите true, если этот Шрифт содержит атрибуты, которые требуют дополнительной обработки расположения.
|
boolean |
hasUniformLineMetrics()
Проверки, действительно ли это
Font имеет универсальные метрики строки. |
boolean |
isBold()
Указывает действительно ли это
Font стиль объекта является ПОЛУЖИРНЫМ. |
boolean |
isItalic()
Указывает действительно ли это
Font стилем объекта является КУРСИВ. |
boolean |
isPlain()
Указывает действительно ли это
Font стиль объекта ПРОСТ. |
boolean |
isTransformed()
Указывает действительно ли это
Font у объекта есть преобразование, которое влияет на его размер в дополнение к атрибуту Размера. |
GlyphVector |
layoutGlyphVector(FontRenderContext frc, char[] text, int start, int limit, int flags)
Возвращает новое
GlyphVector объект, выполняя полное расположение текста если возможный. |
Строка |
toString()
Преобразовывает это
Font возразите против a String представление. |
public static final String DIALOG
public static final String DIALOG_INPUT
public static final String SANS_SERIF
public static final String SERIF
public static final String MONOSPACED
public static final int PLAIN
public static final int BOLD
public static final int ITALIC
public static final int ROMAN_BASELINE
public static final int CENTER_BASELINE
public static final int HANGING_BASELINE
public static final int TRUETYPE_FONT
createFont(int, java.io.InputStream)
метод. Формат TrueType был расширен, чтобы стать форматом OpenType, который добавляет поддержку шрифтов со схемами Постскриптума, этот тег поэтому ссылается на эти шрифты, так же как тех со схемами TrueType.public static final int TYPE1_FONT
createFont(int, java.io.InputStream)
метод.protected String name
Font
, как передано конструктору.getName()
protected int style
Font
, как передано конструктору. Этот стиль может быть ПРОСТЫМ, ПОЛУЖИРНЫМ, КУРСИВ, или BOLD+ITALIC.getStyle()
protected int size
Font
, округленный к целому числу.getSize()
protected float pointSize
Font
в float
.getSize()
, getSize2D()
public static final int LAYOUT_LEFT_TO_RIGHT
public static final int LAYOUT_RIGHT_TO_LEFT
public static final int LAYOUT_NO_START_CONTEXT
public static final int LAYOUT_NO_LIMIT_CONTEXT
public Font(String name, int style, int size)
Font
с указанного имени, стиля и размера точки. Имя шрифта может быть именем поверхности шрифта или именем семейства шрифтов. Это используется вместе со стилем, чтобы найти соответствующую поверхность шрифта. Когда имя семейства шрифтов определяется, параметр стиля используется, чтобы выбрать самую соответствующую поверхность из семейства. Когда имя поверхности шрифта определяется, стиль поверхности и параметр стиля объединяются, чтобы определить местоположение лучшего шрифта соответствия от того же самого семейства. Например, если имя поверхности "Arial, Полужирный", определяется со стилем Font.ITALIC
, система шрифта ищет поверхность в семействе "Arial", которое является полужирным и курсив, и может связать экземпляр шрифта с физической поверхностью шрифта "Полужирный курсив Arial". Параметр стиля объединяется со стилем указанной поверхности, не добавленным или вычтенным. Это означает, определяя полужирный стиль, и полужирный стиль не удваивается - ободряют шрифт, и определение полужирного стиля и простого стиля не освещает шрифт.
Если никакая поверхность для требуемого стиля не может быть найдена, система шрифта может применить алгоритмическое моделирование, чтобы достигнуть требуемого стиля. Например, если ITALIC
требуется, но никакая курсивная поверхность не доступна, глифы от простой поверхности могут быть алгоритмически obliqued (наклонные).
Поиск имени шрифта является нечувствительным к регистру, используя складные метры случая локали US.
Если name
параметр представляет что-то другое чем логический шрифт, то есть интерпретируется как физическая поверхность шрифта или семейство, и это не может быть отображено реализацией на физический шрифт или совместимую альтернативу, тогда система шрифта отобразит экземпляр Шрифта на "Диалоговое окно", так, что например, семейство как сообщающийся getFamily
будет "Диалоговое окно".
name
- имя шрифта. Это может быть именем поверхности шрифта или именем семейства шрифтов, и может представить или логический шрифт или физический шрифт, найденный в этом GraphicsEnvironment
. Фамилии для логических шрифтов: Диалоговое окно, DialogInput, Моноширинный, Засечка, или SansSerif. Предопределенные Строковые константы существуют для всех этих имен, например, DIALOG
. Если name
null
, логическое имя шрифта нового Font
как возвращено getName()
устанавливается в имя "Значение по умолчанию".style
- стиль, постоянный для Font
Параметром стиля является целочисленная битовая маска, которая может быть PLAIN
, или поразрядное объединение BOLD
и/или ITALIC
(например, ITALIC
или BOLD|ITALIC
). Если параметр стиля не соответствует одной из ожидаемых целочисленных битовых масок тогда, стиль устанавливается в PLAIN
.size
- размер точки Font
GraphicsEnvironment.getAllFonts()
, GraphicsEnvironment.getAvailableFontFamilyNames()
public Font(Map<? extends AttributedCharacterIterator.Attribute,?> attributes)
Font
с указанными атрибутами. Только ключи определяются в TextAttribute
распознаются. Кроме того, атрибут ШРИФТА не распознается этим конструктором (см. getAvailableAttributes()
). Только атрибуты, у которых есть значения допустимых типов, будут влиять на новое Font
. Если attributes
null
, новое Font
инициализируется со значениями по умолчанию.
attributes
- атрибуты, чтобы присвоиться к новому Font
, или null
TextAttribute
protected Font(Font font)
Font
от указанного font
. Этот конструктор предназначается для использования подклассами.font
- из которого можно создать это Font
.NullPointerException
- если font
нуль@Deprecated public java.awt.peer.FontPeer getPeer()
Font
.Font
.public static Font getFont(Map<? extends AttributedCharacterIterator.Attribute,?> attributes)
Font
приспособьте атрибутам. Если attributes
содержит a FONT
атрибут с допустимым Font
как его значение, это будет объединено с любыми остающимися атрибутами. См. TextAttribute.FONT
для получения дополнительной информации.attributes
- атрибуты, чтобы присвоиться к новому Font
Font
создаваемый с указанными атрибутамиNullPointerException
- если attributes
нуль.TextAttribute
public static Font createFont(int fontFormat, InputStream fontStream) throws FontFormatException, IOException
Font
использование указанного типа шрифта и входных данных. Новое Font
создается с размером точки 1 и стиль PLAIN
. Этот основной шрифт может тогда использоваться с deriveFont
методы в этом class, чтобы произойти новый Font
объекты с переменными размерами, стилями, преобразовывают и функции шрифта. Этот метод не закрывается InputStream
. Сделать Font
доступный конструкторам Шрифта возвращенный Font
должен быть зарегистрирован в GraphicsEnviroment
вызывая registerFont(Font)
.
fontFormat
- тип Font
, который является TRUETYPE_FONT
если ресурс TrueType определяется. или TYPE1_FONT
если ресурс Типа 1 определяется.fontStream
- InputStream
объект, представляющий входные данные для шрифта.Font
создаваемый с указанным типом шрифта.IllegalArgumentException
- если fontFormat
не TRUETYPE_FONT
илиTYPE1_FONT
.FontFormatException
- если fontStream
данные не содержат необходимые таблицы шрифта для указанного формата.IOException
- если fontStream
не может быть полностью считан.GraphicsEnvironment.registerFont(Font)
public static Font createFont(int fontFormat, File fontFile) throws FontFormatException, IOException
Font
использование указанного типа шрифта и указанного файла шрифта. Новое Font
создается с размером точки 1 и стиль PLAIN
. Этот основной шрифт может тогда использоваться с deriveFont
методы в этом class, чтобы произойти новый Font
объекты с переменными размерами, стилями, преобразовывают и функции шрифта.fontFormat
- тип Font
, который является TRUETYPE_FONT
если ресурс TrueType определяется или TYPE1_FONT
если ресурс Типа 1 определяется. Пока на возвращенный шрифт, или его производные шрифты ссылаются, реализация может продолжать получать доступ fontFile
получать данные шрифта. Таким образом результаты неопределены, если файл изменяется, или становится недоступным. Сделать Font
доступный конструкторам Шрифта возвращенный Font
должен быть зарегистрирован в GraphicsEnviroment
вызывая registerFont(Font)
.
fontFile
- a File
объект, представляющий входные данные для шрифта.Font
создаваемый с указанным типом шрифта.IllegalArgumentException
- если fontFormat
не TRUETYPE_FONT
илиTYPE1_FONT
.NullPointerException
- если fontFile
нуль.IOException
- если fontFile
не может быть считан.FontFormatException
- если fontFile
не содержит необходимые таблицы шрифта для указанного формата.SecurityException
- если у выполняющегося кода нет разрешения, чтобы читать из файла.GraphicsEnvironment.registerFont(Font)
public AffineTransform getTransform()
Font
. Это преобразование является не обязательно тем, используемым, чтобы создать шрифт. Если у шрифта будут алгоритмическое преобразование в верхний индекс или корректировка width, то это будет включено в возвращенный AffineTransform
. Как правило, шрифты не будут преобразованы. Клиенты обычно должны вызвать isTransformed()
во-первых, и только вызовите этот метод если isTransformed
возвращает true.
AffineTransform
объект, представляющий атрибут преобразования этого Font
объект.public String getFamily()
Font
. Фамилия шрифта является определенным шрифтом. У двух шрифтов, таких как Курсив Helvetica и Полужирный Helvetica есть та же самая фамилия, Helvetica, тогда как их имена поверхности шрифта являются Полужирным Helvetica и Курсив Helvetica. Список доступных фамилий может быть получен при использовании GraphicsEnvironment.getAvailableFontFamilyNames()
метод.
Использовать getName
получить логическое имя шрифта. Использовать getFontName
чтобы получить шрифт обращенным к имени шрифта.
String
это - фамилия этого Font
.getName()
, getFontName()
public String getFamily(Locale l)
Font
, локализованный для указанной локали. Фамилия шрифта является определенным шрифтом. У двух шрифтов, таких как Курсив Helvetica и Полужирный Helvetica есть та же самая фамилия, Helvetica, тогда как их имена поверхности шрифта являются Полужирным Helvetica и Курсив Helvetica. Список доступных фамилий может быть получен при использовании GraphicsEnvironment.getAvailableFontFamilyNames()
метод.
Использовать getFontName
чтобы получить шрифт обращенным к имени шрифта.
l
- локаль, для которой можно получить фамилиюString
представление фамилии шрифта, локализованного для указанной локали.getFontName()
, Locale
public String getPSName()
Font
. Использовать getFamily
получить фамилию шрифта. Использовать getFontName
чтобы получить шрифт обращенным к имени шрифта.String
представление имени постскриптума этого Font
.public String getName()
Font
. Использовать getFamily
получить фамилию шрифта. Использовать getFontName
чтобы получить шрифт обращенным к имени шрифта.String
представление логического имени этого Font
.getFamily()
, getFontName()
public String getFontName()
Font
. Например, Полужирный Helvetica мог быть возвращен как имя поверхности шрифта. Использовать getFamily
получить фамилию шрифта. Использовать getName
получить логическое имя шрифта.String
представление шрифта обращенным к имени этого Font
.getFamily()
, getName()
public String getFontName(Locale l)
Font
, локализованный для указанной локали. Например, Helvetica Fett мог быть возвращен как имя поверхности шрифта. Использовать getFamily
получить фамилию шрифта.l
- локаль, для которой можно получить шрифт, обращенным к имениString
представление шрифта обращенным к имени, локализованному для указанной локали.getFamily()
, Locale
public int getStyle()
Font
. Стиль может быть ПРОСТЫМ, ПОЛУЖИРНЫМ, КУРСИВ, или BOLD+ITALIC.Font
isPlain()
, isBold()
, isItalic()
public int getSize()
Font
, округленный к целому числу. Большинство пользователей знакомо с идеей использовать размер точки, чтобы определить размер глифов в шрифте. Этот размер точки определяет измерение между базовой линией одной строки к базовой линии следующей строки в единственном расположенном с интервалами текстовом документе. Размер точки основан на типографских точках, приблизительно 1/72 дюйма. Java (ТМ), 2-D API принимает соглашение, что одна точка эквивалентна одному модулю в пользовательских координатах. При использовании нормализованного преобразования для того, чтобы преобразовать координаты пространства пользователя в пространство устройства координирует 72 модуля пространства пользователя равный 1 дюйм в пространстве устройства. В этом случае одна точка является 1/72 дюйма.
Font
в 1/72 дюйма модули.getSize2D()
, GraphicsConfiguration.getDefaultTransform()
, GraphicsConfiguration.getNormalizingTransform()
public float getSize2D()
Font
в float
значение.Font
как a float
значение.getSize()
public boolean isPlain()
Font
стиль объекта ПРОСТ.true
если это Font
имеет ПЛОСКОСТЬ sytle; false
иначе.getStyle()
public boolean isBold()
Font
стиль объекта является ПОЛУЖИРНЫМ.true
если это Font
стиль объекта является ПОЛУЖИРНЫМ; false
иначе.getStyle()
public boolean isItalic()
Font
стилем объекта является КУРСИВ.true
если это Font
стилем объекта является КУРСИВ; false
иначе.getStyle()
public boolean isTransformed()
Font
у объекта есть преобразование, которое влияет на его размер в дополнение к атрибуту Размера.true
если это Font
у объекта есть неидентификационные данные атрибут AffineTransform. false
иначе.getTransform()
public boolean hasLayoutAttributes()
public static Font getFont(String nm)
Font
объект от системного списка свойств. nm
обрабатывается как имя системного свойства, которое будет получено. String
значение этого свойства тогда интерпретируется как a Font
объект согласно спецификации Font.decode(String)
Если указанное свойство не находится, или у выполняющегося кода нет разрешения, чтобы считать свойство, нуль возвращается вместо этого.nm
- имя свойстваFont
возразите, что имя свойства описывает, или нуль, если никакое такое свойство не существует.NullPointerException
- если нм является нулем.decode(String)
public static Font decode(String str)
Font
то, что str
параметр описывает. Гарантировать, что этот метод возвращает требуемый Шрифт, формат str
параметр одним из этих способов
"PLAIN"
, "BOLD"
, "BOLDITALIC"
, или "ITALIC"
, и размер точки является положительным десятичным целочисленным представлением размера точки. Например, если Вы хотите шрифт, который является Arial, полужирным, с размером точки 18, Вы вызвали бы этот метод с: "Arial-BOLD-18". Это эквивалентно вызову конструктора Шрифта: new Font("Arial", Font.BOLD, 18);
и значения интерпретируются как определено тем конструктором. Допустимое запаздывающее десятичное поле всегда интерпретируется как размер точки. Поэтому имя шрифта, содержащее запаздывающее десятичное значение, не должно использоваться в имени шрифта, только формируются.
Если поле имени стиля не является одной из допустимых строк стиля, это интерпретируется как часть имени шрифта, и стиль значения по умолчанию используется.
Только один из ''или '-' может использоваться, чтобы разделить поля во вводе. Идентифицированный разделитель является одним самым близким до конца строки, которая разделяет допустимый размер точки, или допустимое имя стиля от остальной части строки. Нулевой (пустой) размер точки и поля стиля обрабатываются как допустимые поля со значением по умолчанию для того поля.
Некоторые имена шрифтов могут включать символы разделителя '' или '-'. Если str
не формируется с 3 компонентами, например, так, что style
или pointsize
поля не присутствуют в str
, и fontname
также содержит символ, решенный быть символом разделителя тогда эти символы, где они кажутся как предназначено быть частью fontname
май вместо этого быть интерпретированным как разделители так имя шрифта не может быть должным образом распознан.
Размер значения по умолчанию 12, и стиль значения по умолчанию ПРОСТ. Если str
не определяет допустимый размер, возвращенный Font
имеет размер 12. Если str
не определяет допустимый стиль, у возвращенного Шрифта есть стиль ПЛОСКОСТИ. Если Вы не определяете допустимое имя шрифта в str
параметр, этот метод возвратит шрифт с фамилией "Диалоговое окно". Чтобы определить, какие имена семейства шрифтов доступны на Вашей системе, используйте GraphicsEnvironment.getAvailableFontFamilyNames()
метод. Если str
null
, новое Font
возвращается с фамилией "Диалоговое окно", размер 12 и ПРОСТОЙ стиль.
str
- имя шрифта, или null
Font
возразите этому str
описывает, или новое значение по умолчанию Font
если str
null
.getFamily()
public static Font getFont(String nm, Font font)
Font
от системного списка свойств. Как в getProperty
метод System
, первый параметр обрабатывается как имя системного свойства, которое будет получено. String
значение этого свойства тогда интерпретируется как a Font
объект. Значение свойства должно быть одной из форм, принятых Font.decode(String)
Если указанное свойство не находится, или у выполняющегося кода нет разрешения, чтобы считать свойство, font
параметр возвращается вместо этого.
nm
- нечувствительное к регистру имя свойстваfont
- значение по умолчанию Font
возвратиться если свойство nm
не определяетсяFont
значение свойства.NullPointerException
- если нм является нулем.decode(String)
public int hashCode()
Font
.hashCode
в class Object
Font
.Object.equals(java.lang.Object)
, System.identityHashCode(java.lang.Object)
public boolean equals(Object obj)
Font
возразите против указанного Object
.equals
в class Object
obj
- Object
сравнитьсяtrue
если объекты являются тем же самым или если параметром является a Font
объект, описывающий тот же самый шрифт как этот объект; false
иначе.Object.hashCode()
, HashMap
public String toString()
Font
возразите против a String
представление.public int getNumGlyphs()
Font
. Глиф кодирует для этого Font
диапазон от 0 до getNumGlyphs()
- 1.Font
.public int getMissingGlyphCode()
Font
не имеет глифа для указанной unicode кодовой точки.Font
.public byte getBaselineFor(char c)
Большие шрифты могут поддерживать различные системы письменности, и каждая система может использовать различную базовую линию. Символьный параметр определяет систему письменности, чтобы использовать. Клиенты не должны предположить, что все символы используют ту же самую базовую линию.
c
- символ, используемый, чтобы идентифицировать систему письменностиLineMetrics.getBaselineOffsets()
, ROMAN_BASELINE
, CENTER_BASELINE
, HANGING_BASELINE
public Map<TextAttribute,?> getAttributes()
Font
. Атрибуты включают вещи как замена глифа и лигатуры.Font
.public AttributedCharacterIterator.Attribute[] getAvailableAttributes()
Font
. Эти атрибуты могут использоваться, чтобы получить другие шрифты.Font
.public Font deriveFont(int style, float size)
Font
объект, тиражируя это Font
возразите и применение нового стиля и размера.style
- стиль для нового Font
size
- размер для нового Font
Font
объект.public Font deriveFont(int style, AffineTransform trans)
Font
объект, тиражируя это Font
возразите и применение нового стиля и преобразуйте.style
- стиль для нового Font
trans
- AffineTransform
связанный с новым Font
Font
объект.IllegalArgumentException
- если trans
null
public Font deriveFont(float size)
Font
объект, тиражируя ток Font
возразите и применение нового размера к этому.size
- размер для нового Font
.Font
объект.public Font deriveFont(AffineTransform trans)
Font
объект, тиражируя ток Font
возразите и применение нового преобразования к этому.trans
- AffineTransform
связанный с новым Font
Font
объект.IllegalArgumentException
- если trans
null
public Font deriveFont(int style)
Font
объект, тиражируя ток Font
возразите и применение нового стиля к этому.style
- стиль для нового Font
Font
объект.public Font deriveFont(Map<? extends AttributedCharacterIterator.Attribute,?> attributes)
Font
объект, тиражируя ток Font
возразите и применение нового набора шрифта приписывает этому.attributes
- карта атрибутов включается для нового Font
Font
объект.public boolean canDisplay(char c)
Font
имеет глифа для указанного символа. Отметьте: Этот метод не может обработать дополнительные символы. Поддерживать все символы Unicode, включая дополнительные символы, использование canDisplay(int)
метод или canDisplayUpTo
методы.
c
- символ, для которого необходим глифtrue
если это Font
имеет глифа для этого символа; false
иначе.public boolean canDisplay(int codePoint)
Font
имеет глифа для указанного символа.codePoint
- символ (кодовая точка Unicode), для которого необходим глиф.true
если это Font
имеет глифа для символа; false
иначе.IllegalArgumentException
- если кодовая точка не является допустимой кодовой точкой Unicode.Character.isValidCodePoint(int)
public int canDisplayUpTo(String str)
Font
может вывести на экран указанное String
. Для строк с кодированием Unicode важно знать, может ли определенный шрифт вывести на экран строку. Этот метод возвращает смещение в String
str
который является первым символом это Font
не может вывести на экран, не используя недостающий код глифа. Если Font
может вывести на экран все символы,-1 возвращается.str
- a String
объектstr
это указывает на первый символ в str
то, что это Font
не может вывести на экран; или -1
если это Font
может вывести на экран все символы в str
.public int canDisplayUpTo(char[] text, int start, int limit)
Font
может вывести на экран символы в указанном text
запуск в start
и окончание в limit
. Этот метод является перегрузкой удобства.text
- указанный массив char
значенияstart
- указанное начальное смещение (в char
s) в указанный массив char
значенияlimit
- указанное смещение окончания (в char
s) в указанный массив char
значенияtext
это указывает на первый символ в text
то, что это Font
не может вывести на экран; или -1
если это Font
может вывести на экран все символы в text
.public int canDisplayUpTo(CharacterIterator iter, int start, int limit)
Font
может вывести на экран текст, определенный iter
запуск в start
и окончание в limit
.iter
- a CharacterIterator
объектstart
- указанный запуск смещается в указанное CharacterIterator
.limit
- указанное окончание смещается в указанное CharacterIterator
.iter
это указывает на первый символ в iter
то, что это Font
не может вывести на экран; или -1
если это Font
может вывести на экран все символы в iter
.public float getItalicAngle()
Font
. Курсивный угол является обратным наклоном каре который лучшие соответствия положение этого Font
.Font
.TextAttribute.POSTURE
public boolean hasUniformLineMetrics()
Font
имеет универсальные метрики строки. Логическое Font
мог бы быть составной шрифт, что означает, что он составляется из различных физических шрифтов, чтобы покрыть различные диапазоны кода. Каждый из этих шрифтов мог бы иметь отличающийся LineMetrics
. Если логическое Font
единственный шрифт тогда, метрики были бы универсальны.true
если это Font
имеет универсальные метрики строки; false
иначе.public LineMetrics getLineMetrics(String str, FontRenderContext frc)
str
- указанное String
frc
- указанное FontRenderContext
LineMetrics
объект создается с указанным String
и FontRenderContext
.public LineMetrics getLineMetrics(String str, int beginIndex, int limit, FontRenderContext frc)
LineMetrics
объект создается с указанными параметрами.str
- указанное String
beginIndex
- начальное смещение str
limit
- смещение конца str
frc
- указанное FontRenderContext
LineMetrics
объект создается с указанными параметрами.public LineMetrics getLineMetrics(char[] chars, int beginIndex, int limit, FontRenderContext frc)
LineMetrics
объект создается с указанными параметрами.chars
- массив символовbeginIndex
- начальное смещение chars
limit
- смещение конца chars
frc
- указанное FontRenderContext
LineMetrics
объект создается с указанными параметрами.public LineMetrics getLineMetrics(CharacterIterator ci, int beginIndex, int limit, FontRenderContext frc)
LineMetrics
объект создается с указанными параметрами.ci
- указанное CharacterIterator
beginIndex
- начальное смещение в ci
limit
- смещение конца ci
frc
- указанное FontRenderContext
LineMetrics
объект создается с указанными параметрами.public Rectangle2D getStringBounds(String str, FontRenderContext frc)
String
в указанном FontRenderContext
. Логические границы содержат источник, подъем, усовершенствование, и height, который включает продвижение. Логические границы не всегда включают весь текст. Например, на некоторых языках и в некоторых шрифтах, метки диакритического знака могут быть расположены выше подъема или ниже спуска. Получить визуальный ограничивающий прямоугольник, который включает весь текст, использование getBounds
метод TextLayout
. Отметьте: возвращенные границы находятся в базово-относительных координатах (см. class notes
).
str
- указанное String
frc
- указанное FontRenderContext
Rectangle2D
это - ограничивающий прямоугольник указанного String
в указанном FontRenderContext
.FontRenderContext
, createGlyphVector(java.awt.font.FontRenderContext, java.lang.String)
public Rectangle2D getStringBounds(String str, int beginIndex, int limit, FontRenderContext frc)
String
в указанном FontRenderContext
. Логические границы содержат источник, подъем, усовершенствование, и height, который включает продвижение. Логические границы не всегда включают весь текст. Например, на некоторых языках и в некоторых шрифтах, метки диакритического знака могут быть расположены выше подъема или ниже спуска. Получить визуальный ограничивающий прямоугольник, который включает весь текст, использование getBounds
метод TextLayout
. Отметьте: возвращенные границы находятся в базово-относительных координатах (см. class notes
).
str
- указанное String
beginIndex
- начальное смещение str
limit
- смещение конца str
frc
- указанное FontRenderContext
Rectangle2D
это - ограничивающий прямоугольник указанного String
в указанном FontRenderContext
.IndexOutOfBoundsException
- если beginIndex
меньше чем нуль, или limit
больше чем длина str
, или beginIndex
больше чем limit
.FontRenderContext
, createGlyphVector(java.awt.font.FontRenderContext, java.lang.String)
public Rectangle2D getStringBounds(char[] chars, int beginIndex, int limit, FontRenderContext frc)
FontRenderContext
. Логические границы содержат источник, подъем, усовершенствование, и height, который включает продвижение. Логические границы не всегда включают весь текст. Например, на некоторых языках и в некоторых шрифтах, метки диакритического знака могут быть расположены выше подъема или ниже спуска. Получить визуальный ограничивающий прямоугольник, который включает весь текст, использование getBounds
метод TextLayout
. Отметьте: возвращенные границы находятся в базово-относительных координатах (см. class notes
).
chars
- массив символовbeginIndex
- начальное смещение в массиве символовlimit
- конец смещается в массиве символовfrc
- указанное FontRenderContext
Rectangle2D
это - ограничивающий прямоугольник указанного массива символов в указанном FontRenderContext
.IndexOutOfBoundsException
- если beginIndex
меньше чем нуль, или limit
больше чем длина chars
, или beginIndex
больше чем limit
.FontRenderContext
, createGlyphVector(java.awt.font.FontRenderContext, java.lang.String)
public Rectangle2D getStringBounds(CharacterIterator ci, int beginIndex, int limit, FontRenderContext frc)
CharacterIterator
в указанном FontRenderContext
. Логические границы содержат источник, подъем, усовершенствование, и height, который включает продвижение. Логические границы не всегда включают весь текст. Например, на некоторых языках и в некоторых шрифтах, метки диакритического знака могут быть расположены выше подъема или ниже спуска. Получить визуальный ограничивающий прямоугольник, который включает весь текст, использование getBounds
метод TextLayout
. Отметьте: возвращенные границы находятся в базово-относительных координатах (см. class notes
).
ci
- указанное CharacterIterator
beginIndex
- начальное смещение в ci
limit
- смещение конца в ci
frc
- указанное FontRenderContext
Rectangle2D
это - ограничивающий прямоугольник символов, индексированных в указанном CharacterIterator
в указанном FontRenderContext
.IndexOutOfBoundsException
- если beginIndex
меньше, чем запуск индексирует ci
, или limit
больше, чем конец индексирует ci
, или beginIndex
больше чем limit
FontRenderContext
, createGlyphVector(java.awt.font.FontRenderContext, java.lang.String)
public Rectangle2D getMaxCharBounds(FontRenderContext frc)
FontRenderContext
. Отметьте: возвращенные границы находятся в базово-относительных координатах (см. class notes
).
frc
- указанное FontRenderContext
Rectangle2D
это - ограничивающий прямоугольник для символа с максимальными границами.public GlyphVector createGlyphVector(FontRenderContext frc, String str)
GlyphVector
отображая символы на глифов, непосредственных основанный на Unicode cmap в этом Font
. Этот метод не делает никакой другой обработки помимо отображения глифов к символам. Это означает, что этот метод не является полезным для некоторых сценариев, таким как арабский, иврит, тайский язык, и Относящимся к Индии, которые требуют переупорядочения, формирования, или замены лигатуры.frc
- указанное FontRenderContext
str
- указанное String
GlyphVector
создаваемый с указанным String
и указанное FontRenderContext
.public GlyphVector createGlyphVector(FontRenderContext frc, char[] chars)
GlyphVector
отображая символы на глифов, непосредственных основанный на Unicode cmap в этом Font
. Этот метод не делает никакой другой обработки помимо отображения глифов к символам. Это означает, что этот метод не является полезным для некоторых сценариев, таким как арабский, иврит, тайский язык, и Относящимся к Индии, которые требуют переупорядочения, формирования, или замены лигатуры.frc
- указанное FontRenderContext
chars
- указанный массив символовGlyphVector
создаваемый с указанным массивом символов и указанного FontRenderContext
.public GlyphVector createGlyphVector(FontRenderContext frc, CharacterIterator ci)
GlyphVector
отображая указанные символы на глифов, непосредственных основанный на Unicode cmap в этом Font
. Этот метод не делает никакой другой обработки помимо отображения глифов к символам. Это означает, что этот метод не является полезным для некоторых сценариев, таким как арабский, иврит, тайский язык, и Относящимся к Индии, которые требуют переупорядочения, формирования, или замены лигатуры.frc
- указанное FontRenderContext
ci
- указанное CharacterIterator
GlyphVector
создаваемый с указанным CharacterIterator
и указанное FontRenderContext
.public GlyphVector createGlyphVector(FontRenderContext frc, int[] glyphCodes)
GlyphVector
отображая символы на глифов, непосредственных основанный на Unicode cmap в этом Font
. Этот метод не делает никакой другой обработки помимо отображения глифов к символам. Это означает, что этот метод не является полезным для некоторых сценариев, таким как арабский, иврит, тайский язык, и Относящимся к Индии, которые требуют переупорядочения, формирования, или замены лигатуры.frc
- указанное FontRenderContext
glyphCodes
- указанный целочисленный массивGlyphVector
создаваемый с указанным целочисленным массивом и указанным FontRenderContext
.public GlyphVector layoutGlyphVector(FontRenderContext frc, char[] text, int start, int limit, int flags)
GlyphVector
объект, выполняя полное расположение текста если возможный. Полное расположение требуется для сложного текста, такого как арабский или хинди. Поддержка различных сценариев зависит от шрифта и реализации. Расположение требует bidi анализа, как выполняющийся Bidi
, и должен только быть выполнен на тексте, у которого есть универсальное направление. Направление обозначается в параметре флагов, при использовании LAYOUT_RIGHT_TO_LEFT, чтобы указать справа налево (арабский и иврит) выполненное направление, или LAYOUT_LEFT_TO_RIGHT, чтобы указать на слева направо (английское) направление выполнения.
Кроме того, некоторые операции, такие как арабское формирование, требуют контекста, так, чтобы у символов в запуске и пределе могли быть надлежащие формы. Иногда у данных в буферной внешней стороне обеспеченный диапазон нет допустимых данных. Значения LAYOUT_NO_START_CONTEXT и LAYOUT_NO_LIMIT_CONTEXT могут быть добавлены к параметру флагов, чтобы указать, что текст прежде запускается, или после предела, соответственно, не должны быть исследованы на контекст.
Все другие значения для параметра флагов резервируются.
frc
- указанное FontRenderContext
text
- текст к расположениюstart
- запуск текста, чтобы использовать для GlyphVector
limit
- предел текста, чтобы использовать для GlyphVector
flags
- управляйте флагами как описано вышеGlyphVector
представление текста между запуском и пределом, с глифами, выбранными и расположенными, чтобы лучше всего представить текстArrayIndexOutOfBoundsException
- если запускаются, или предел за пределыBidi
, LAYOUT_LEFT_TO_RIGHT
, LAYOUT_RIGHT_TO_LEFT
, LAYOUT_NO_START_CONTEXT
, LAYOUT_NO_LIMIT_CONTEXT
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92