Класс TextAttribute

Все реализованные интерфейсы:
Serializable
public final class TextAttribute
extends AttributedCharacterIterator.Attribute

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

Экземпляры TextAttribute используются в качестве ключей атрибутов для идентификации атрибутов в классах Font, TextLayout, AttributedCharacterIterator и других классах, обрабатывающих атрибуты текста. Другие константы, определённые в этом классе, могут быть использованы в качестве значений атрибутов.

Для каждого атрибута текста документация предоставляет:

  • тип его значения,
  • соответствующие предопределённые константы (если есть),
  • эффект по умолчанию, если атрибут отсутствует,
  • допустимые значения (если есть ограничения),
  • описание эффекта.

Значения

  • Значения атрибутов всегда должны быть неизменяемыми.
  • В случаях, когда приводятся ограничения на значения, любые значения за пределами этого набора зарезервированы для будущего использования; значение будет обработано как значение по умолчанию.
  • Значение null обрабатывается так же, как значение по умолчанию, и приводит к стандартному поведению.
  • Если значение не является правильного типа, атрибут будет проигнорирован.
  • Тождество значения не имеет значения, важен только сам фактический параметр. Например, TextAttribute.WEIGHT_BOLD и Float.valueOf(2.0f) указывают на одно и то же WEIGHT.
  • Значения атрибутов типа Number (используемых для WEIGHT, WIDTH, POSTURE, SIZE, JUSTIFICATION, и TRACKING ) могут варьироваться в пределах своего естественного диапазона и не ограничены предопределенными константами. Number.floatValue() используется для получения фактического значения из Number.
  • Значения для WEIGHT, WIDTH, и POSTURE интерполируются системой, которая может выбрать «самый близкий доступный» шрифт или использовать другие методы для приближения запроса пользователя.

Сводная таблица атрибутов

Ключ Тип значения Основные константы Значение по умолчанию
FAMILY Строка См. шрифт DIALOG, DIALOG_INPUT,
SERIF, SANS_SERIF и MONOSPACED. 		"Default" (используется системный шрифт по умолчанию)
WEIGHT Число WEIGHT_REGULAR, WEIGHT_BOLD WEIGHT_REGULAR
WIDTH Число WIDTH_CONDENSED, WIDTH_REGULAR,
WIDTH_EXTENDED 		WIDTH_REGULAR
POSTURE Число POSTURE_REGULAR, POSTURE_OBLIQUE POSTURE_REGULAR
SIZE Число нет 12.0
TRANSFORM TransformAttribute См. TransformAttribute IDENTITY TransformAttribute.IDENTITY
SUPERSCRIPT Целое число SUPERSCRIPT_SUPER, SUPERSCRIPT_SUB 0 (используются стандартные глифы и метрики)
FONT Font нет null (не переопределять разрешение шрифтов)
CHAR_REPLACEMENT GraphicAttribute нет null (рисовать текст с использованием глифов шрифта)
FOREGROUND Paint нет null (использовать текущую краску графики)
BACKGROUND Paint нет null (не рендерить фон)
UNDERLINE Целое число UNDERLINE_ON -1 (не рендерить подчеркивание)
STRIKETHROUGH Булево STRIKETHROUGH_ON false (не рендерить зачеркнутый текст)
RUN_DIRECTION Булево RUN_DIRECTION_LTR
RUN_DIRECTION_RTL 		null (использовать стандартный режим по умолчанию Bidi)
BIDI_EMBEDDING Целое число нет 0 (использовать направление основной линии)
JUSTIFICATION Число JUSTIFICATION_FULL JUSTIFICATION_FULL
INPUT_METHOD_HIGHLIGHT InputMethodHighlight,
Annotation 		(см. класс) null (не применять подсветку ввода)
INPUT_METHOD_UNDERLINE Целое число UNDERLINE_LOW_ONE_PIXEL,
UNDERLINE_LOW_TWO_PIXEL 		-1 (не рендерить подчеркивание)
SWAP_COLORS Булево SWAP_COLORS_ON false (не переключать цвета)
NUMERIC_SHAPING NumericShaper нет null (не форматировать цифры)
KERNING Целое число KERNING_ON 0 (не запрашивать кернинг)
LIGATURES Целое число LIGATURES_ON 0 (не формировать опциональные лигатуры)
TRACKING Число TRACKING_LOOSE, TRACKING_TIGHT 0 (не добавлять трекинг)
См. также:
Font, TextLayout, AttributedCharacterIterator, Сериализованная форма

Поля

Модификатор и тип Поле Описание
static TextAttribute BACKGROUND

Ключ атрибута для цвета заливки фона текста.
static TextAttribute BIDI_EMBEDDING

Ключ атрибута для уровня встраивания текста.
static TextAttribute CHAR_REPLACEMENT

Ключ атрибута для пользовательского глифа, отображаемого вместо стандартного глифа шрифта для символа.
static TextAttribute FAMILY

Ключ атрибута для имени шрифта.
static TextAttribute FONT

Ключ атрибута для указания шрифта, используемого для отображения текста.
static TextAttribute FOREGROUND

Ключ атрибута для цвета заливки текста.
static TextAttribute INPUT_METHOD_HIGHLIGHT

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

Ключ атрибута для подчеркиваний метода ввода.
static TextAttribute JUSTIFICATION

Ключ атрибута для выравнивания абзаца.
static Float JUSTIFICATION_FULL

Выровнять строку по всей запрошенной ширине.
static Float JUSTIFICATION_NONE

Не разрешать выравнивание строки.
static TextAttribute KERNING

Ключ атрибута для запроса кернинга.
static Integer KERNING_ON

Запрос стандартного кернинга.
static TextAttribute LIGATURES

Ключ атрибута для включения опциональных лигатур.
static Integer LIGATURES_ON

Запрос стандартных опциональных лигатур.
static TextAttribute NUMERIC_SHAPING

Ключ атрибута для преобразования десятичных цифр ASCII в другие десятичные диапазоны.
static TextAttribute POSTURE

Ключ атрибута для наклона шрифта.
static Float POSTURE_OBLIQUE

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

Стандартный наклон — прямой.
static TextAttribute RUN_DIRECTION

Ключ атрибута для направления строки.
static Boolean RUN_DIRECTION_LTR

Направление слева направо.
static Boolean RUN_DIRECTION_RTL

Направление справа налево.
static TextAttribute SIZE

Ключ атрибута для размера шрифта.
static TextAttribute STRIKETHROUGH

Ключ атрибута для перечеркнутого текста.
static Boolean STRIKETHROUGH_ON

Один перечеркнутый элемент.
static TextAttribute SUPERSCRIPT

Ключ атрибута для надстрочных и подстрочных индексов.
static Integer SUPERSCRIPT_SUB

Стандартный подстрочный индекс.
static Integer SUPERSCRIPT_SUPER

Стандартный надстрочный индекс.
static TextAttribute SWAP_COLORS

Ключ атрибута для перестановки переднего и заднего Paints.

static Boolean SWAP_COLORS_ON

Перестановка переднего и заднего планов.
static TextAttribute TRACKING

Ключ атрибута для управления отслеживанием.
static Float TRACKING_LOOSE

Выполнить свободное отслеживание.
static Float TRACKING_TIGHT

Выполнить строгое отслеживание.
static TextAttribute TRANSFORM

Ключ атрибута для преобразования шрифта.
static TextAttribute UNDERLINE

Ключ атрибута для подчеркивания.
static Integer UNDERLINE_LOW_DASHED

Однопиксельное пунктирное подчеркивание снизу.
static Integer UNDERLINE_LOW_DOTTED

Однопиксельное точечное подчеркивание снизу.
static Integer UNDERLINE_LOW_GRAY

Двухпиксельное серое подчеркивание снизу.
static Integer UNDERLINE_LOW_ONE_PIXEL

Однопиксельное сплошное подчеркивание снизу.
static Integer UNDERLINE_LOW_TWO_PIXEL

Двухпиксельное сплошное подчеркивание снизу.
static Integer UNDERLINE_ON

Стандартное подчеркивание.
static TextAttribute WEIGHT

Ключ атрибута для толщины шрифта.
static Float WEIGHT_BOLD

Стандартная жирность.
static Float WEIGHT_DEMIBOLD

Несколько светлее, чем WEIGHT_BOLD.
static Float WEIGHT_DEMILIGHT

Промежуточная жирность между WEIGHT_LIGHT и WEIGHT_STANDARD.
static Float WEIGHT_EXTRA_LIGHT

Самая легкая предопределенная жирность.
static Float WEIGHT_EXTRABOLD

Очень жирная жирность.
static Float WEIGHT_HEAVY

Несколько жирнее, чем WEIGHT_BOLD.
static Float WEIGHT_LIGHT

Стандартная лёгкая жирность.
static Float WEIGHT_MEDIUM

Промежуточная жирность между WEIGHT_REGULAR и WEIGHT_BOLD.
static Float WEIGHT_REGULAR

Стандартная жирность.
static Float WEIGHT_SEMIBOLD

Несколько жирнее, чем WEIGHT_REGULAR.
static Float WEIGHT_ULTRABOLD

Самая жирная предопределённая жирность.
static TextAttribute WIDTH

Ключ атрибута для ширины шрифта.
static Float WIDTH_CONDENSED

Самая сжатая предопределённая ширина.
static Float WIDTH_EXTENDED

Самая расширенная предопределённая ширина.
static Float WIDTH_REGULAR

Стандартная ширина.
static Float WIDTH_SEMI_CONDENSED

Несколько сжатая ширина.
static Float WIDTH_SEMI_EXTENDED

Несколько расширенная ширина.

Поля, объявленные в классе java.text.AttributedCharacterIterator.Attribute

INPUT_METHOD_SEGMENT, LANGUAGE, READING

Краткое описание конструкторов

Модификатор Конструктор Описание
protected TextAttribute​(String name)

Создаёт TextAttribute с указанным именем.

Краткое описание методов

Модификатор и тип Метод Описание
protected Object readResolve()

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

Методы, объявленные в классе java.text.AttributedCharacterIterator.Attribute

equals, getName, hashCode, toString

Методы, объявленные в классе java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Поля

FAMILY

public static final TextAttribute FAMILY

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

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

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

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

WEIGHT

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.

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

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

WEIGHT_EXTRA_LIGHT

public static final Float WEIGHT_EXTRA_LIGHT

Самый лёгкий предварительно определённый вес.

См. также:
WEIGHT

WEIGHT_LIGHT

public static final Float WEIGHT_LIGHT

Стандартный лёгкий вес.

См. также:
WEIGHT

WEIGHT_DEMILIGHT

public static final Float WEIGHT_DEMILIGHT

Промежуточный вес между WEIGHT_LIGHT и WEIGHT_STANDARD.

См. также:
WEIGHT

WEIGHT_REGULAR

public static final Float WEIGHT_REGULAR

Стандартный вес. Это значение по умолчанию для WEIGHT.

См. также:
WEIGHT

WEIGHT_SEMIBOLD

public static final Float WEIGHT_SEMIBOLD

Умеренно более тяжёлый вес, чем WEIGHT_REGULAR.

См. также:
WEIGHT

WEIGHT_MEDIUM

public static final Float WEIGHT_MEDIUM

Промежуточный вес между WEIGHT_REGULAR и WEIGHT_BOLD.

См. также:
WEIGHT

WEIGHT_DEMIBOLD

public static final Float WEIGHT_DEMIBOLD

Умеренно более лёгкий вес, чем WEIGHT_BOLD.

См. также:
WEIGHT

WEIGHT_BOLD

public static final Float WEIGHT_BOLD

Стандартный жирный вес.

См. также:
WEIGHT

WEIGHT_HEAVY

public static final Float WEIGHT_HEAVY

Умеренно более тяжёлый вес, чем WEIGHT_BOLD.

См. также:
WEIGHT

WEIGHT_EXTRABOLD

public static final Float WEIGHT_EXTRABOLD

Чрезвычайно тяжёлый вес.

См. также:
WEIGHT

WEIGHT_ULTRABOLD

public static final Float WEIGHT_ULTRABOLD

Самый тяжёлый предварительно определённый вес.

См. также:
WEIGHT

WIDTH

public static final TextAttribute WIDTH

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

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

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

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

WIDTH_CONDENSED

public static final Float WIDTH_CONDENSED

Самая сжатая предварительно определённая ширина.

См. также:
WIDTH

WIDTH_SEMI_CONDENSED

public static final Float WIDTH_SEMI_CONDENSED

Умеренно сжатая ширина.

См. также:
WIDTH

WIDTH_REGULAR

public static final Float WIDTH_REGULAR

Стандартная ширина. Это значение по умолчанию для WIDTH.

См. также:
WIDTH

WIDTH_SEMI_EXTENDED

public static final Float WIDTH_SEMI_EXTENDED

Умеренно расширенная ширина.

См. также:
WIDTH

WIDTH_EXTENDED

public static final Float WIDTH_EXTENDED

Самая расширенная предварительно определённая ширина.

См. также:
WIDTH

POSTURE

public static final TextAttribute POSTURE

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

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

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

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

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

См. также:
Font.getItalicAngle()

POSTURE_REGULAR

public static final Float POSTURE_REGULAR

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

См. также:
POSTURE

POSTURE_OBLIQUE

public static final Float POSTURE_OBLIQUE

Стандартное курсивное начертание.

См. также:
POSTURE

SIZE

public static final TextAttribute SIZE

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

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

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

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

TRANSFORM

public static final TextAttribute TRANSFORM

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

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

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

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

Некоторые преобразования вызовут вращение и/или смещение базовой линии. Текст и базовая линия преобразуются вместе, так что текст следует за новой базовой линией. Например, при тексте на горизонтальной базовой линии новая базовая линия следует направлению единичного вектора x, переданного через преобразование. Метрики текста измеряются по отношению к этой новой базовой линии. Например, при прочих равных условиях текст, отрисованный с поворотным ПРЕОБРАЗОВАНИЕМ и неповоротным ПРЕОБРАЗОВАНИЕМ, будет измеряться как имеющий одинаковый подъем, спуск и продвижение.

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

См. также:
TransformAttribute, AffineTransform

SUPERSCRIPT

public static final TextAttribute SUPERSCRIPT

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

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

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

SUPERSCRIPT_SUPER

public static final Integer SUPERSCRIPT_SUPER

Стандартный надстрочный знак.

См. также:
SUPERSCRIPT

SUPERSCRIPT_SUB

public static final Integer SUPERSCRIPT_SUB

Стандартный подстрочный знак.

См. также:
SUPERSCRIPT

FONT

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.

См. также:
Font

CHAR_REPLACEMENT

public static final TextAttribute CHAR_REPLACEMENT

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

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

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

См. также:
GraphicAttribute

FOREGROUND

public static final TextAttribute FOREGROUND

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

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

См. также:
Paint, SWAP_COLORS

BACKGROUND

public static final TextAttribute BACKGROUND

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

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

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

См. также:
Paint, SWAP_COLORS

UNDERLINE

public static final TextAttribute UNDERLINE

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

Предоставлено постоянное значение UNDERLINE_ON.

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

UNDERLINE_ON

public static final Integer UNDERLINE_ON

Стандартное подчёркивание.

См. также:
UNDERLINE

STRIKETHROUGH

public static final TextAttribute STRIKETHROUGH

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

Предоставлено постоянное значение STRIKETHROUGH_ON.

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

STRIKETHROUGH_ON

public static final Boolean STRIKETHROUGH_ON

Одно перечёркивание.

См. также:
STRIKETHROUGH

RUN_DIRECTION

public static final TextAttribute RUN_DIRECTION

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

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

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

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

См. также:
Bidi

RUN_DIRECTION_LTR

public static final Boolean RUN_DIRECTION_LTR

Направление слева направо.

См. также:
RUN_DIRECTION

RUN_DIRECTION_RTL

public static final Boolean RUN_DIRECTION_RTL

Направление справа налево.

См. также:
RUN_DIRECTION

BIDI_EMBEDDING

public static final TextAttribute BIDI_EMBEDDING

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

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

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

См. также:
Bidi

JUSTIFICATION

public static final TextAttribute JUSTIFICATION

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

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

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

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

См. также:
TextLayout.getJustifiedLayout(float)

JUSTIFICATION_FULL

public static final Float JUSTIFICATION_FULL

Выровнять строку по всей запрошенной ширине. Это значение по умолчанию для JUSTIFICATION.

См. также:
JUSTIFICATION

JUSTIFICATION_NONE

public static final Float JUSTIFICATION_NONE

Не допускать выравнивания строки.

См. также:
JUSTIFICATION

INPUT_METHOD_HIGHLIGHT

public static final TextAttribute INPUT_METHOD_HIGHLIGHT

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

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

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

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

См. также:
Font, InputMethodHighlight, Annotation

INPUT_METHOD_UNDERLINE

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, если необходимо. Основное назначение — использование методами ввода. Другое использование этих подчеркиваний для простого украшения может сбить пользователей с толку.

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

С:
1.3

UNDERLINE_LOW_ONE_PIXEL

public static final Integer UNDERLINE_LOW_ONE_PIXEL

Однопиксельное сплошное подчеркивание снизу.

С:
1.3
См. также:
INPUT_METHOD_UNDERLINE

UNDERLINE_LOW_TWO_PIXEL

public static final Integer UNDERLINE_LOW_TWO_PIXEL

Двухпиксельное сплошное подчеркивание снизу.

С:
1.3
См. также:
INPUT_METHOD_UNDERLINE

UNDERLINE_LOW_DOTTED

public static final Integer UNDERLINE_LOW_DOTTED

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

С:
1.3
См. также:
INPUT_METHOD_UNDERLINE

UNDERLINE_LOW_GRAY

public static final Integer UNDERLINE_LOW_GRAY

Двухпиксельное серое подчеркивание снизу.

С:
1.3
См. также:
INPUT_METHOD_UNDERLINE

UNDERLINE_LOW_DASHED

public static final Integer UNDERLINE_LOW_DASHED

Однопиксельное штриховое подчеркивание снизу.

С:
1.3
См. также:
INPUT_METHOD_UNDERLINE

SWAP_COLORS

public static final TextAttribute SWAP_COLORS

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

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

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

См. также:
FOREGROUND, BACKGROUND

SWAP_COLORS_ON

public static final Boolean SWAP_COLORS_ON

Переключить цвета переднего и заднего плана.

С:
1.3
См. также:
SWAP_COLORS

NUMERIC_SHAPING

public static final TextAttribute NUMERIC_SHAPING

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

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

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

С:
1.4
См. также:
NumericShaper

KERNING

public static final TextAttribute KERNING

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

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

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

С:
1.6

KERNING_ON

public static final Integer KERNING_ON

Запрос стандартного кернинга.

С:
1.6
См. также:
KERNING

LIGATURES

public static final TextAttribute LIGATURES

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

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

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

С:
1.6

LIGATURES_ON

public static final Integer LIGATURES_ON

Запрос стандартных необязательных лигатур.

С:
1.6
См. также:
LIGATURES

TRACKING

public static final TextAttribute TRACKING

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

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

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

С:
1.6

TRACKING_TIGHT

public static final Float TRACKING_TIGHT

Выполнить плотный трекинг.

С:
1.6
См. также:
TRACKING

TRACKING_LOOSE

public static final Float TRACKING_LOOSE

Выполнить свободный трекинг.

С:
1.6
См. также:
TRACKING

Конструкторы

TextAttribute

protected TextAttribute(String name)

Создает TextAttribute с указанным именем.

Параметры:
name - имя атрибута, присваиваемое этому TextAttribute

Методы

readResolve

protected Object readResolve()
                      throws InvalidObjectException

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

Переопределяет:
readResolve в классе AttributedCharacterIterator.Attribute
Возвращает:
разрешенный объект Attribute
Исключения:
InvalidObjectException - если разрешаемый объект не является экземпляром Attribute

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/11/docs/api/java.desktop/java/awt/font/TextAttribute.html

Spec-Zone .ru
спецификации, руководства, описания, API