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

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

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

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

public static final Float POSTURE_REGULAR

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

public static final Float POSTURE_OBLIQUE

Стандартный курсивный наклон.

public static final TextAttribute SIZE

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

Это соответствует параметру 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, что указывает на то, что должна выполняться обычная обработка получения шрифта из атрибутов.

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). Каждый символ (кодовая точка Юникода) будет отрисован с помощью предоставленного 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 bidi (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

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