Класс TextAttribute

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

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

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

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

Ключ атрибута для толщины шрифта. Значения являются экземплярами 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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

FONT используется для особых ситуаций, когда у клиентов уже есть экземпляр Font, но им все равно нужно использовать API на основе Map. Как правило, в Map не будет других атрибутов, кроме атрибута FONT. С API на основе Map в общем случае требуется указывать все атрибуты индивидуально, поэтому FONT не требуется или нежелателен.

Однако, если в FONT и в Map присутствуют и другие атрибуты, система рендеринга объединит атрибуты, определенные в 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.

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

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

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

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

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

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

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

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

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

Предоставляется константа UNDERLINE_ON.

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

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

Предоставляется константа STRIKETHROUGH_ON.

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

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

Предоставляются константы RUN_DIRECTION_RTL и RUN_DIRECTION_LTR.

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

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

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

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

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

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

Предоставляются константы JUSTIFICATION_FULL и JUSTIFICATION_NONE.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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