Класс 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 , но всё ещё нуждаются в использовании Map-базированных API. Обычно в Map не будет других атрибутов, кроме атрибута FONT . С Map -базированными API в общем случае указываются все атрибуты индивидуально, поэтому 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.

public static final TextAttribute CHAR_REPLACEMENT

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

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

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

public static final TextAttribute FOREGROUND

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

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

public static final TextAttribute BACKGROUND

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

Логические границы текста будут заполнены этой краской, а затем текст будет отрисован поверх неё (но см. 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 bidi (RLO, LRO, RLE, LRE и PDF) в абзаце игнорируются, а участки текста, где этот атрибут отсутствует, обрабатываются так, как будто он присутствует и имеет значение 0.

public static final TextAttribute JUSTIFICATION

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

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

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