Класс 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

Заменяет десериализованные экземпляры предопределёнными константами.