Класс 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. Значение по умолчанию равно 12pt.

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

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

Обратите внимание, что внешний вид и метрики шрифта 12pt с преобразованием 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.getFont(Map) для обработки атрибута FONT.

public static final TextAttribute CHAR_REPLACEMENT

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

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

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

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, что указывает на выполнение алгоритма Bidi без явных вложений.

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

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

public static final TextAttribute JUSTIFICATION

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

Указывает долю дополнительного пространства, используемого при выравнивании строки в 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

Разрешает экземпляры, которые сериализуются до предопределённых констант.