Класс TextAttribute

public static final TextAttribute FAMILY

Ключ атрибута для имени шрифта. Значениями являются экземпляры String. Значение по умолчанию — "Default", что приводит к использованию семейства шрифтов платформы по умолчанию.

Класс Font определяет константы для логических имён шрифтов DIALOG, DIALOG_INPUT, SANS_SERIF, SERIF и MONOSPACED.

Определяет значение, передаваемое в качестве name конструктору Font. Допускаются как логические, так и физические имена шрифтов. Если шрифт с запрошенным именем не найден, используется шрифт по умолчанию.

Примечание: К сожалению, этот атрибут назван неверно, поскольку он задаёт имя начертания, а не только семейства. Поэтому при наличии начертания со значением вроде «Lucida Sans Bold» будет выбрано именно оно. Однако если запрошенного начертания нет, будет использован шрифт по умолчанию с обычной насыщенностью. Слово «Bold» в имени является частью имени начертания, а не отдельным запросом на полужирное начертание шрифта.

public static final TextAttribute WEIGHT

Ключ атрибута для насыщенности шрифта. Значениями являются экземпляры Number. Значение по умолчанию — WEIGHT_REGULAR.

Предусмотрено несколько константных значений; см. WEIGHT_EXTRA_LIGHT, WEIGHT_LIGHT, WEIGHT_DEMILIGHT, WEIGHT_REGULAR, WEIGHT_SEMIBOLD, WEIGHT_MEDIUM, WEIGHT_DEMIBOLD, WEIGHT_BOLD, WEIGHT_HEAVY, WEIGHT_EXTRABOLD и WEIGHT_ULTRABOLD. Значение WEIGHT_BOLD соответствует значению стиля Font.BOLD, передаваемому конструктору Font.

Значение приблизительно равно отношению ширины штриха к ширине штриха обычной насыщенности.

Система может интерполировать заданное значение.

public static final Float WEIGHT_EXTRA_LIGHT

Самая лёгкая из предопределённых насыщенностей.

public static final Float WEIGHT_LIGHT

Стандартная лёгкая насыщенность.

public static final Float WEIGHT_DEMILIGHT

Промежуточная насыщенность между WEIGHT_LIGHT и WEIGHT_STANDARD.

public static final Float WEIGHT_REGULAR

Стандартная насыщенность. Это значение по умолчанию для WEIGHT.

public static final Float WEIGHT_SEMIBOLD

Умеренно более высокая насыщенность, чем WEIGHT_REGULAR.

public static final Float WEIGHT_MEDIUM

Промежуточная насыщенность между WEIGHT_REGULAR и WEIGHT_BOLD.

public static final Float WEIGHT_DEMIBOLD

Умеренно более низкая насыщенность, чем WEIGHT_BOLD.

public static final Float WEIGHT_BOLD

Стандартная полужирная насыщенность.

public static final Float WEIGHT_HEAVY

Умеренно более высокая насыщенность, чем WEIGHT_BOLD.

public static final Float WEIGHT_EXTRABOLD

Особо высокая насыщенность.

public static final Float WEIGHT_ULTRABOLD

Самая высокая из предопределённых насыщенностей.

public static final TextAttribute WIDTH

Ключ атрибута для ширины шрифта. Значениями являются экземпляры Number. Значение по умолчанию — WIDTH_REGULAR.

Предусмотрено несколько константных значений; см. WIDTH_CONDENSED, WIDTH_SEMI_CONDENSED, WIDTH_REGULAR, WIDTH_SEMI_EXTENDED, WIDTH_EXTENDED.

Значение приблизительно равно отношению ширины продвижения к ширине продвижения обычного начертания.

Система может интерполировать заданное значение.

public static final Float WIDTH_CONDENSED

Самая узкая из предопределённых ширин.

public static final Float WIDTH_SEMI_CONDENSED

Умеренно суженная ширина.

public static final Float WIDTH_REGULAR

Стандартная ширина. Это значение по умолчанию для WIDTH.

public static final Float WIDTH_SEMI_EXTENDED

Умеренно расширенная ширина.

public static final Float WIDTH_EXTENDED

Самая широкая из предопределённых ширин.

public static final TextAttribute POSTURE

Ключ атрибута для наклона шрифта. Значениями являются экземпляры Number. Значение по умолчанию — POSTURE_REGULAR.

Предусмотрено два константных значения: POSTURE_REGULAR и POSTURE_OBLIQUE. Значение POSTURE_OBLIQUE соответствует значению стиля Font.ITALIC, передаваемому конструктору Font.

Значение приблизительно соответствует наклону штрихов шрифта, выраженному как отношение горизонтального смещения к вертикальному. Положительные значения задают наклон вправо.

Система может интерполировать заданное значение.

Это влияет на угол наклона шрифта, возвращаемый методом Font.getItalicAngle.

public static final Float POSTURE_REGULAR

Стандартное, прямое начертание. Это значение по умолчанию для POSTURE.

public static final Float POSTURE_OBLIQUE

Стандартное курсивное начертание.

public static final TextAttribute SIZE

Ключ атрибута для размера шрифта. Значениями являются экземпляры Number. Значение по умолчанию — 12 пт.

Соответствует параметру size конструктора Font.

Очень большие или маленькие размеры могут снижать производительность отображения, а система визуализации может не отображать текст таких размеров. Отрицательные размеры недопустимы; в этом случае используется размер по умолчанию.

Обратите внимание, что внешний вид и метрики шрифта размером 12 пт с преобразованием 2x могут отличаться от внешнего вида и метрик шрифта размером 24 пт без преобразования.

public static final TextAttribute TRANSFORM

Ключ атрибута для преобразования шрифта. Значениями являются экземпляры TransformAttribute. Значение по умолчанию — TransformAttribute.IDENTITY.

Класс TransformAttribute определяет константу IDENTITY.

Соответствует преобразованию, переданному в Font.deriveFont(AffineTransform). Поскольку это преобразование является изменяемым, а значения TextAttribute не должны быть изменяемыми, используется класс-обёртка TransformAttribute.

Основное назначение — поддержка масштабирования и наклона, хотя возможны и другие эффекты.

Некоторые преобразования приводят к повороту и/или смещению базовой линии. Текст и базовая линия преобразуются вместе, поэтому текст следует за новой базовой линией. Например, если текст расположен на горизонтальной базовой линии, новая базовая линия будет направлена вдоль единичного вектора x, преобразованного с помощью преобразования. Метрики текста измеряются относительно этой новой базовой линии. Поэтому, например, при прочих равных текст, отображаемый с повёрнутым TRANSFORM и без поворота TRANSFORM, будет иметь одинаковые высоту прописных, глубину и ширину продвижения.

В стилизованном тексте базовые линии каждого такого фрагмента выравниваются последовательно, что потенциально создаёт нелинейную базовую линию для всего фрагмента текста. Дополнительные сведения см. в разделе TextLayout.getLayoutPath().

public static final TextAttribute SUPERSCRIPT

Ключ атрибута для надстрочного и подстрочного индексов. Значениями являются экземпляры Integer. Значение по умолчанию — 0, то есть надстрочный или подстрочный индекс не используется.

Предусмотрено два константных значения; см. SUPERSCRIPT_SUPER и SUPERSCRIPT_SUB. Их значения равны соответственно 1 и -1. Значения с большей абсолютной величиной задают более высокие уровни надстрочного или подстрочного индекса: например, 2 соответствует надстрочному индексу над надстрочным, 3 — надстрочному индексу над ним и так далее; аналогично для отрицательных значений и подстрочных индексов, вплоть до уровня 7 (или -7). Значения за пределами этого диапазона зарезервированы; поведение зависит от платформы.

SUPERSCRIPT может влиять на высоту прописных и глубину шрифта. Однако высота прописных и глубина не могут стать отрицательными.

public static final Integer SUPERSCRIPT_SUPER

Стандартный надстрочный индекс.

public static final Integer SUPERSCRIPT_SUB

Стандартный подстрочный индекс.

public static final TextAttribute FONT

Ключ атрибута, используемый для задания шрифта, которым следует отображать текст. Значениями являются экземпляры Font. Значение по умолчанию — null, что указывает на необходимость обычного определения Font по атрибутам.

TextLayout и AttributedCharacterIterator работают с Maps объекта TextAttributes. Обычно все атрибуты проверяются и используются для выбора и настройки экземпляра Font. Однако если присутствует атрибут FONT, будет использоваться связанный с ним Font. Это позволяет пользователям переопределять преобразование атрибутов шрифта в Font или принудительно использовать конкретный экземпляр Font. Это также позволяет задавать подклассы Font в случаях, когда Font можно расширить.

FONT используется в особых случаях, когда клиенты уже располагают экземпляром Font, но им по-прежнему необходимо использовать API на основе Map. Обычно в Map не будет других атрибутов, кроме атрибута FONT. При использовании API на основе Map обычно задаются все атрибуты по отдельности, поэтому FONT не требуется и не рекомендуется.

Однако если в Map присутствуют как FONT, так и другие атрибуты, система визуализации объединит атрибуты, определённые в Font, с дополнительными атрибутами. В процессе объединения TextAttributes делятся на две группы. Первая группа, «основная», считается принципиально важной для выбора шрифта и определения его метрик. К этим атрибутам относятся FAMILY, WEIGHT, WIDTH, POSTURE, SIZE, TRANSFORM, SUPERSCRIPT и TRACKING. Вторая группа, «вторичная», включает все остальные определённые атрибуты, за исключением самого FONT.

Чтобы создать новый Map, сначала из атрибута FONT извлекается Font, после чего все его атрибуты копируются в новый Map. Затем к атрибутам нового Map добавляются только вторичные атрибуты исходного Map. Таким образом, значения основных атрибутов берутся только из Font, а значения вторичных атрибутов — из Font, но их можно переопределить другими значениями в Map.

Примечание: Конструктор на основе Font's Map и методы deriveFont не обрабатывают атрибут FONT, поскольку они используются для создания новых объектов Font. Для обработки атрибута FONT следует использовать метод Font.getFont(Map).

public static final TextAttribute CHAR_REPLACEMENT

Ключ атрибута для пользовательского глифа, отображаемого вместо стандартного глифа шрифта для символа. Значениями являются экземпляры GraphicAttribute. Значение по умолчанию — null, что указывает на использование стандартных глифов, предоставляемых шрифтом.

Этот атрибут используется для резервирования места под графический или другой компонент, встроенный в строку текста. Он необходим для правильного позиционирования «встроенных» компонентов в строке при выполнении двунаправленной переупорядоченности (см. Bidi). Каждый символ (кодовая точка Unicode) будет отображаться с помощью предоставленного GraphicAttribute. Как правило, символы, к которым применяется этот атрибут, должны быть \uFFFC.

GraphicAttribute определяет логические и визуальные границы текста; фактические значения Font игнорируются.

public static final TextAttribute FOREGROUND

Ключ атрибута для цвета, используемого при отображении текста. Значениями являются экземпляры Paint. Значение по умолчанию — null, что указывает на использование Paint, заданного для Graphics2D на момент отображения.

Глифы будут отображаться с использованием этого Paint независимо от значения Paint, заданного для Graphics (см. также SWAP_COLORS).

public static final TextAttribute BACKGROUND

Ключ атрибута для цвета, используемого при отображении фона текста. Значениями являются экземпляры Paint. Значение по умолчанию — null, что указывает на то, что фон отображаться не должен.

Логические границы текста будут залиты этим Paint, после чего поверх них будет отображён текст (см. также SWAP_COLORS).

При необходимости визуальные границы текста расширяются, чтобы включить логические границы. Контур не изменяется.

public static final TextAttribute UNDERLINE

Ключ атрибута для подчёркивания. Значениями являются экземпляры Integer. Значение по умолчанию — -1, что означает отсутствие подчёркивания.

Предусмотрено константное значение UNDERLINE_ON.

Подчёркивание влияет как на визуальные границы, так и на контур текста.

public static final Integer UNDERLINE_ON

Стандартное подчёркивание.

public static final TextAttribute STRIKETHROUGH

Ключ атрибута для зачёркивания. Значениями являются экземпляры Boolean. Значение по умолчанию — false, что означает отсутствие зачёркивания.

Предусмотрено константное значение STRIKETHROUGH_ON.

Зачёркивание влияет как на визуальные границы, так и на контур текста.

public static final Boolean STRIKETHROUGH_ON

Одиночное зачёркивание.

public static final TextAttribute RUN_DIRECTION

Ключ атрибута для направления фрагмента строки. Значениями являются экземпляры Boolean. Значение по умолчанию — null, что указывает на использование стандартного алгоритма Bidi для определения направления фрагмента со значением Bidi.DIRECTION_DEFAULT_LEFT_TO_RIGHT.

Предусмотрены константы RUN_DIRECTION_RTL и RUN_DIRECTION_LTR.

Определяет значение, передаваемое конструктору Bidi для выбора основного направления текста в абзаце.

Примечание: Для всего текста в абзаце должно быть задано одинаковое значение этого атрибута; в противном случае поведение не определено.

public static final Boolean RUN_DIRECTION_LTR

Направление фрагмента слева направо.

public static final Boolean RUN_DIRECTION_RTL

Направление фрагмента справа налево.

public static final TextAttribute BIDI_EMBEDDING

Ключ атрибута для уровня вложенности текста. Значениями являются экземпляры Integer. Значение по умолчанию — null, указывающее на то, что двунаправленный алгоритм должен выполняться без явных уровней вложенности.

Положительные значения от 1 до 61 задают уровни вложения, отрицательные значения от -1 до -61 — уровни переопределения. Значение 0 означает, что используется направление базовой строки. Эти уровни передаются в массиве уровней вложенности конструктору Bidi.

Примечание: Если этот атрибут присутствует где-либо в абзаце, все управляющие символы двунаправленного текста Unicode (RLO, LRO, RLE, LRE и PDF) в абзаце игнорируются, а фрагменты текста, в которых этот атрибут отсутствует, обрабатываются так, как если бы он присутствовал со значением 0.

public static final TextAttribute JUSTIFICATION

Ключ атрибута для выравнивания абзаца. Значениями являются экземпляры Number. Значение по умолчанию — 1, что указывает на использование всей заданной ширины при выравнивании. Значения ограничиваются диапазоном [0..1].

Предусмотрены константы JUSTIFICATION_FULL и JUSTIFICATION_NONE.

Задаёт долю дополнительного пространства, используемого при выравнивании TextLayout. Например, если ширина строки составляет 50 пунктов, а её требуется выровнять до 70 пунктов, значение 0.75 добавит три четверти оставшегося пространства, то есть 15 пунктов, и итоговая длина строки составит 65 пунктов.

Примечание: Для всего текста в абзаце должно быть задано одинаковое значение; в противном случае поведение не определено.

public static final Float JUSTIFICATION_FULL

Выровнять строку по всей заданной ширине. Это значение по умолчанию для JUSTIFICATION.

public static final Float JUSTIFICATION_NONE

Не выполнять выравнивание строки.

public static final TextAttribute INPUT_METHOD_HIGHLIGHT

Ключ атрибута для стилей выделения метода ввода.

Значениями являются экземпляры InputMethodHighlight или Annotation. Значение по умолчанию — null, что означает, что стили метода ввода не применяются перед отображением.

Если соседние фрагменты текста с одинаковым InputMethodHighlight требуется отображать отдельно, InputMethodHighlights следует обернуть в экземпляры Annotation.

Выделение метода ввода используется во время составления текста методом ввода. Компоненты редактирования текста должны сохранять эти выделения, даже если обычно работают только с текстом без стилей, и предоставлять их процедурам рисования.

public static final TextAttribute INPUT_METHOD_UNDERLINE

Ключ атрибута для подчёркиваний метода ввода. Значениями являются экземпляры Integer. Значение по умолчанию — -1, что означает отсутствие подчёркивания.

Предусмотрено несколько константных значений; см. UNDERLINE_LOW_ONE_PIXEL, UNDERLINE_LOW_TWO_PIXEL, UNDERLINE_LOW_DOTTED, UNDERLINE_LOW_GRAY и UNDERLINE_LOW_DASHED.

При необходимости этот атрибут можно использовать вместе с UNDERLINE. В первую очередь он предназначен для методов ввода. Использование этих подчёркиваний для простого украшения может сбить пользователей с толку.

Подчёркивание метода ввода влияет как на визуальные границы, так и на контур текста.

public static final Integer UNDERLINE_LOW_ONE_PIXEL

Сплошное нижнее подчёркивание толщиной в один пиксель.

public static final Integer UNDERLINE_LOW_TWO_PIXEL

Сплошное нижнее подчеркивание толщиной в два пикселя.

public static final Integer UNDERLINE_LOW_DOTTED

Точечное нижнее подчеркивание толщиной в один пиксель.

public static final Integer UNDERLINE_LOW_GRAY

Серое нижнее подчеркивание толщиной в два пикселя.

public static final Integer UNDERLINE_LOW_DASHED

Штриховое нижнее подчеркивание толщиной в один пиксель.

public static final TextAttribute SWAP_COLORS

Ключ атрибута для обмена Paints переднего плана и фона. Значениями являются экземпляры Boolean. Значение по умолчанию — false, то есть цвета не меняются местами.

Определено константное значение SWAP_COLORS_ON.

Если задан атрибут FOREGROUND, его Paint будет использоваться в качестве фона; в противном случае будет использоваться Paint, имеющийся в данный момент на Graphics. Если задан атрибут BACKGROUND, его Paint будет использоваться в качестве цвета переднего плана; в противном случае система подберет контрастный цвет относительно (вычисленного) цвета фона, чтобы текст оставался видимым.

public static final Boolean SWAP_COLORS_ON

Поменять местами цвета переднего плана и фона.

public static final TextAttribute NUMERIC_SHAPING

Ключ атрибута для преобразования десятичных цифр ASCII в другие диапазоны десятичных цифр. Значениями являются экземпляры NumericShaper. Значение по умолчанию — null, то есть числовое формообразование не выполняется.

Если задан преобразователь чисел, перед любым другим анализом текста он сначала обрабатывается этим преобразователем.

Примечание: Значение этого атрибута должно быть одинаковым для всего текста абзаца; в противном случае поведение не определено.

public static final TextAttribute KERNING

Ключ атрибута для включения кернинга. Значениями являются экземпляры Integer. Значение по умолчанию — 0, при котором кернинг не включается.

Предоставлено константное значение KERNING_ON.

Стандартные интервалы для отдельных символов не подходят для некоторых последовательностей, например «To» или «AWAY». Без кернинга кажется, что между соседними символами слишком большой интервал. Кернинг изменяет интервалы в выбранных последовательностях символов, улучшая их визуальное восприятие.

public static final Integer KERNING_ON

Запросить стандартный кернинг.

public static final TextAttribute LIGATURES

Ключ атрибута для включения необязательных лигатур. Значениями являются экземпляры Integer. Значение по умолчанию — 0, то есть необязательные лигатуры не используются.

Определено константное значение LIGATURES_ON.

Лигатуры, обязательные для системы письменности, всегда включены.

public static final Integer LIGATURES_ON

Запросить стандартные необязательные лигатуры.

public static final TextAttribute TRACKING

Ключ атрибута для управления трекингом. Значениями являются экземпляры Number. Значение по умолчанию — 0, то есть дополнительный трекинг не применяется.

Предоставлены константные значения TRACKING_TIGHT и TRACKING_LOOSE.

Значение трекинга умножается на размер шрифта в пунктах, а затем преобразуется с помощью преобразования шрифта, чтобы определить дополнительную величину, прибавляемую к ширине каждой группы глифов. Положительные значения трекинга препятствуют образованию необязательных лигатур. Обычно значения трекинга находятся в диапазоне от -0.1 до 0.3; значения за пределами этого диапазона, как правило, нежелательны.

public static final Float TRACKING_TIGHT

Выполнять плотный трекинг.

public static final Float TRACKING_LOOSE

Выполнять разреженный трекинг.

protected TextAttribute(String name)

Создает TextAttribute с указанным именем.

protected Object readResolve() throws InvalidObjectException

Преобразует десериализуемые экземпляры в предопределенные константы.