Класс StyleContext
- Все реализуемые интерфейсы:
Serializable, AbstractDocument.AttributeContext
- Прямые известные подклассы:
StyleSheet
public class StyleContext extends Object implements Serializable, AbstractDocument.AttributeContext
Этот класс также обеспечивает эффективную поддержку небольших наборов атрибутов и сжимает их, совместно используя их в разных случаях и пользуясь их неизменяемостью. Поскольку многие стили повторяются, возможности для совместного использования значительны, а копирование может быть чрезвычайно дешёвым. В больших наборах вероятность совместного использования снижается, поэтому они автоматически переходят к менее эффективной по занимаемому пространству реализации.
Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими выпусками Swing. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями, работающими с одной и той же версией Swing. Начиная с версии 1.4 в пакете java.beans добавлена поддержка долгосрочного хранения всех JavaBeans. См. XMLEncoder.
Краткое описание вложенных классов
| Модификатор и тип | Класс | Описание |
|---|---|---|
class |
StyleContext.NamedStyle |
Коллекция атрибутов, обычно используемая для представления стилей символов и абзацев. |
class |
StyleContext.SmallAttributeSet |
Этот класс хранит небольшое количество атрибутов в массиве. |
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
static final String |
DEFAULT_STYLE |
Имя, присвоенное стилю по умолчанию, логически связанному с абзацами. |
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
StyleContext() |
Создаёт новый объект StyleContext. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
AttributeSet |
addAttribute |
Добавляет атрибут в указанный набор и возвращает новый репрезентативный набор. |
AttributeSet |
addAttributes |
Добавляет набор атрибутов элементу. |
void |
addChangeListener |
Добавляет слушателя для отслеживания добавления и удаления стилей. |
Style |
addStyle |
Добавляет новый стиль в иерархию стилей. |
protected MutableAttributeSet |
createLargeAttributeSet |
Создаёт большой набор атрибутов, в котором экономия времени достигается за счёт расхода памяти. |
protected StyleContext.SmallAttributeSet |
createSmallAttributeSet |
Создаёт компактный набор атрибутов, который можно совместно использовать. |
Color |
getBackground |
Преобразует набор атрибутов в спецификацию цвета фона. |
ChangeListener[] |
getChangeListeners() |
Возвращает массив всех ChangeListenerов, добавленных в этот StyleContext с помощью addChangeListener(). |
protected int |
getCompressionThreshold() |
Возвращает максимальное количество пар ключ/значение, которые следует попытаться сжать в уникальные/неизменяемые наборы. |
static final StyleContext |
getDefaultStyleContext() |
Возвращает контекст атрибутов по умолчанию, совместно используемый всеми документами, которые не определяют и не предоставляют собственный контекст. |
AttributeSet |
getEmptySet() |
Получает пустой набор атрибутов. |
Font |
getFont |
Получает новый шрифт. |
Font |
getFont |
Получает шрифт из набора атрибутов. |
FontMetrics |
getFontMetrics |
Возвращает метрики шрифта. |
Color |
getForeground |
Преобразует набор атрибутов в спецификацию цвета переднего плана. |
static Object |
getStaticAttribute |
Возвращает объект, ранее зарегистрированный с помощью registerStaticAttributeKey. |
static Object |
getStaticAttributeKey |
Возвращает строку, с которой будет зарегистрирован key. |
Style |
getStyle |
Получает именованный стиль, ранее добавленный в документ |
Enumeration |
getStyleNames() |
Получает имена определённых стилей. |
void |
readAttributes |
Обработка чтения атрибутов с учётом контекста |
static void |
readAttributeSet |
Считывает набор атрибутов из указанного входного потока объектов, ранее записанный с помощью writeAttributeSet. |
void |
reclaim |
Возвращает набор, который больше не нужен реализации MutableAttributeSet. |
static void |
registerStaticAttributeKey |
Регистрирует объект как статический объект, используемый в качестве ключа в наборах атрибутов. |
AttributeSet |
removeAttribute |
Удаляет атрибут из набора. |
AttributeSet |
removeAttributes |
Удаляет набор атрибутов элемента. |
AttributeSet |
removeAttributes |
Удаляет набор атрибутов элемента. |
void |
removeChangeListener |
Удаляет слушателя, отслеживающего добавление и удаление стилей. |
void |
removeStyle |
Удаляет именованный стиль, ранее добавленный в документ. |
String |
toString() |
Преобразует StyleContext в строку. |
void |
writeAttributes |
Обработка записи атрибутов с учётом контекста |
static void |
writeAttributeSet |
Записывает набор атрибутов в указанный поток объектов для сериализации. |
Методы, объявленные в классе Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait | Модификатор и тип | Метод | Описание |
|---|---|---|
protected Object |
clone() |
Создаёт и возвращает копию этого объекта. |
boolean |
equals |
Указывает, равен ли этот объект какому-либо другому объекту. |
protected void |
finalize() |
Устарело, будет удалено: этот элемент API может быть удалён в будущей версии. Финализация объявлена устаревшей и может быть удалена в одном из будущих выпусков. |
final Class |
getClass() |
Возвращает класс среды выполнения этого Object. |
int |
hashCode() |
Возвращает хеш-код этого объекта. |
final void |
notify() |
Пробуждает один поток, ожидающий на мониторе этого объекта. |
final void |
notifyAll() |
Пробуждает все потоки, ожидающие на мониторе этого объекта. |
final void |
wait() |
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt. |
final void |
wait |
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения заданного промежутка реального времени. |
final void |
wait |
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения заданного промежутка реального времени. |
Подробное описание полей
DEFAULT_STYLE
public static final String DEFAULT_STYLE
- См. также:
Подробное описание конструкторов
StyleContext
public StyleContext()
Подробное описание методов
getDefaultStyleContext
public static final StyleContext getDefaultStyleContext()
- Возвращает:
- контекст
addStyle
public Style addStyle(String nm, Style parent)
- Параметры:
-
nm— имя стиля (должно быть уникальным в коллекции именованных стилей документа). Имя может быть null, если стиль не имеет имени, однако вызывающий код должен самостоятельно управлять возвращенной ссылкой, поскольку получить безымянный стиль по имени невозможно. Безымянный стиль может быть полезен, например, для переопределения атрибутов символов, как это происходит в диапазоне стиля. -
parent— родительский стиль. Может быть null, если неуказанные атрибуты не требуется разрешать в другом стиле. - Возвращает:
- созданный стиль
removeStyle
public void removeStyle(String nm)
- Параметры:
-
nm— имя удаляемого стиля
getStyle
public Style getStyle(String nm)
- Параметры:
-
nm— имя стиля - Возвращает:
- стиль
getStyleNames
public Enumeration<?> getStyleNames()
- Возвращает:
- список имен в виде перечисления
addChangeListener
public void addChangeListener(ChangeListener l)
- Параметры:
-
l— слушатель изменений
removeChangeListener
public void removeChangeListener(ChangeListener l)
- Параметры:
-
l— слушатель изменений
getChangeListeners
public ChangeListener[] getChangeListeners()
ChangeListeners, добавленных в этот StyleContext с помощью addChangeListener().- Возвращает:
- все добавленные
ChangeListeners или пустой массив, если слушатели не добавлялись - Начиная с:
- 1.4
getFont
public Font getFont(AttributeSet attr)
- Параметры:
-
attr— набор атрибутов - Возвращает:
- шрифт
getForeground
public Color getForeground(AttributeSet attr)
- Параметры:
-
attr— набор атрибутов - Возвращает:
- цвет
getBackground
public Color getBackground(AttributeSet attr)
- Параметры:
-
attr— набор атрибутов - Возвращает:
- цвет
getFont
public Font getFont(String family, int style, int size)
- Параметры:
-
family— семейство шрифтов (например, "Monospaced") -
style— начертание шрифта (например, Font.PLAIN) -
size— размер в пунктах >= 1 - Возвращает:
- новый шрифт
getFontMetrics
public FontMetrics getFontMetrics(Font f)
- Параметры:
-
f— шрифт - Возвращает:
- метрики
addAttribute
public AttributeSet addAttribute(AttributeSet old, Object name, Object value)
Этот метод потокобезопасен, хотя большинство методов Swing таковыми не являются. Дополнительные сведения см. в разделе Параллелизм в Swing.
- Определено в:
-
addAttributeв интерфейсеAbstractDocument.AttributeContext - Параметры:
-
old— старый набор атрибутов -
name— имя атрибута, не равное null -
value— значение атрибута - Возвращает:
- обновленный набор атрибутов
- См. также:
addAttributes
public AttributeSet addAttributes(AttributeSet old, AttributeSet attr)
Этот метод потокобезопасен, хотя большинство методов Swing таковыми не являются. Дополнительные сведения см. в разделе Параллелизм в Swing.
- Определено в:
-
addAttributesв интерфейсеAbstractDocument.AttributeContext - Параметры:
-
old— старый набор атрибутов -
attr— добавляемые атрибуты - Возвращает:
- обновленный набор атрибутов
- См. также:
removeAttribute
public AttributeSet removeAttribute(AttributeSet old, Object name)
Этот метод потокобезопасен, хотя большинство методов Swing таковыми не являются. Дополнительные сведения см. в разделе Параллелизм в Swing.
- Определено в:
-
removeAttributeв интерфейсеAbstractDocument.AttributeContext - Параметры:
-
old— старый набор атрибутов -
name— имя атрибута, не равное null - Возвращает:
- обновленный набор атрибутов
- См. также:
removeAttributes
public AttributeSet removeAttributes(AttributeSet old, Enumeration<?> names)
Этот метод потокобезопасен, хотя большинство методов Swing таковыми не являются. Дополнительные сведения см. в разделе Параллелизм в Swing.
- Определено в:
-
removeAttributesв интерфейсеAbstractDocument.AttributeContext - Параметры:
-
old— старый набор атрибутов -
names— имена атрибутов - Возвращает:
- обновленный набор атрибутов
- См. также:
removeAttributes
public AttributeSet removeAttributes(AttributeSet old, AttributeSet attrs)
Этот метод потокобезопасен, хотя большинство методов Swing таковыми не являются. Дополнительные сведения см. в разделе Параллелизм в Swing.
- Определено в:
-
removeAttributesв интерфейсеAbstractDocument.AttributeContext - Параметры:
-
old— старый набор атрибутов -
attrs— атрибуты - Возвращает:
- обновленный набор атрибутов
- См. также:
getEmptySet
public AttributeSet getEmptySet()
- Определено в:
-
getEmptySetв интерфейсеAbstractDocument.AttributeContext - Возвращает:
- набор
reclaim
public void reclaim(AttributeSet a)
Этот метод потокобезопасен, хотя большинство методов Swing таковыми не являются. Дополнительные сведения см. в разделе Параллелизм в Swing.
- Определено в:
-
reclaimв интерфейсеAbstractDocument.AttributeContext - Параметры:
-
a— набор, который требуется вернуть
getCompressionThreshold
protected int getCompressionThreshold()
- Возвращает:
- пороговое значение
createSmallAttributeSet
protected StyleContext.SmallAttributeSet createSmallAttributeSet(AttributeSet a)
- Параметры:
-
a— набор атрибутов, который требуется представить в компактной форме. - Возвращает:
- компактный набор атрибутов, который можно совместно использовать
createLargeAttributeSet
protected MutableAttributeSet createLargeAttributeSet(AttributeSet a)
- Параметры:
-
a— набор атрибутов, который требуется представить в расширенной форме. - Возвращает:
- большой набор атрибутов, в котором скорость работы достигается за счет увеличения занимаемого пространства
toString
writeAttributes
public void writeAttributes(ObjectOutputStream out, AttributeSet a) throws IOException
- Параметры:
-
out— выходной поток -
a— набор атрибутов - Исключения:
-
IOException— при любой ошибке ввода-вывода
readAttributes
public void readAttributes(ObjectInputStream in, MutableAttributeSet a) throws ClassNotFoundException, IOException
- Параметры:
-
in— поток объектов, из которого считываются данные атрибутов. -
a— набор атрибутов, в который помещаются определения атрибутов. - Исключения:
-
ClassNotFoundException— передается выше по стеку, если возникает при чтении потока объектов. -
IOException— передается выше по стеку, если возникает при чтении потока объектов.
writeAttributeSet
public static void writeAttributeSet(ObjectOutputStream out, AttributeSet a) throws IOException
registerStaticAttributeKey. Любой ключ атрибута, не зарегистрированный как статический, сериализуется напрямую. Предполагается, что все значения допускают сериализацию.- Параметры:
-
out— выходной поток -
a— набор атрибутов - Исключения:
-
IOException— при любой ошибке ввода-вывода
readAttributeSet
public static void readAttributeSet(ObjectInputStream in, MutableAttributeSet a) throws ClassNotFoundException, IOException
writeAttributeSet. Метод пытается восстановить ключи, являвшиеся статическими объектами, как статические объекты в текущей виртуальной машине, учитывая только ключи, зарегистрированные с помощью метода registerStaticAttributeKey. Полученные из потока атрибуты помещаются в указанный изменяемый набор.- Параметры:
-
in— поток объектов, из которого считываются данные атрибутов. -
a— набор атрибутов, в который помещаются определения атрибутов. - Исключения:
-
ClassNotFoundException— передается выше по стеку, если возникает при чтении потока объектов. -
IOException— передается выше по стеку, если возникает при чтении потока объектов.
registerStaticAttributeKey
public static void registerStaticAttributeKey(Object key)
Для работы в виртуальной машине версии 1.1 используется значение, возвращаемое toString, к которому добавляется имя класса. Возвращаемое методом toString значение не должно содержать ссылку на класс (то есть метод следует переопределить согласно определению в Object), чтобы при последующем вычислении получить то же значение.
- Параметры:
-
key— ключ-объект, не равный null
getStaticAttribute
public static Object getStaticAttribute(Object key)
registerStaticAttributeKey.- Параметры:
-
key— ключ-объект - Возвращает:
- Возвращает объект, ранее зарегистрированный с помощью
registerStaticAttributeKey
getStaticAttributeKey
public static Object getStaticAttributeKey(Object key)
key.- Параметры:
-
key— ключ-объект - Возвращает:
- строка, с которой будет зарегистрирован
key - См. также:
© 1993, 2025, 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.