Интерфейс AttributeSet
- Все известные подинтерфейсы:
-
MutableAttributeSet,Style
- Все известные реализующие классы:
-
AbstractDocument.AbstractElement,AbstractDocument.BranchElement,AbstractDocument.LeafElement,DefaultStyledDocument.SectionElement,HTMLDocument.BlockElement,HTMLDocument.RunElement,SimpleAttributeSet,StyleContext.NamedStyle,StyleContext.SmallAttributeSet
public interface AttributeSet
Коллекция уникальных атрибутов. Это интерфейс только для чтения, неизменяемый. Атрибут — это, по сути, ключ и значение, присвоенные этому ключу. Коллекция может представлять собой, например, набор стилей, логический стиль и т. п. Обычно они используются для описания характеристик, которые будут влиять на какое-либо графическое представление, например, шрифт. Набор возможных ключей не ограничен и может быть любым. Обычно реализации View реагируют на определения атрибутов и отображают что-либо для представления этих атрибутов.
Атрибуты могут потенциально разрешаться иерархически. Если ключ не разрешается локально, и существует разрешающий родитель, ключ будет разрешен через родителя.
- См. также:
Краткое описание вложенных классов
| Модификатор и тип | Интерфейс | Описание |
|---|---|---|
static interface |
AttributeSet.CharacterAttribute |
Этот интерфейс является сигнатурой типа, которая должна присутствовать в любом ключе атрибута, который вносит вклад в представление на уровне символов. |
static interface |
AttributeSet.ColorAttribute |
Этот интерфейс является сигнатурой типа, которая должна присутствовать в любом ключе атрибута, который вносит вклад в представление цвета. |
static interface |
AttributeSet.FontAttribute |
Этот интерфейс является сигнатурой типа, которая должна присутствовать в любом ключе атрибута, который вносит вклад в определение шрифта для рендеринга текста. |
static interface |
AttributeSet.ParagraphAttribute |
Этот интерфейс является сигнатурой типа, которая должна присутствовать в любом ключе атрибута, который вносит вклад в представление на уровне абзаца. |
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
static final Object |
NameAttribute |
Имя атрибута, используемое для наименования коллекции атрибутов. |
static final Object |
ResolveAttribute |
Имя атрибута, используемое для идентификации разрешающего родительского набора атрибутов, если он определен. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
boolean |
containsAttribute |
Возвращает true, если этот набор определяет атрибут с тем же именем и равным значением. |
boolean |
containsAttributes |
Возвращает true, если этот набор определяет все атрибуты из данного набора с равными значениями. |
AttributeSet |
copyAttributes() |
Возвращает набор атрибутов, который гарантированно не изменится со временем. |
Object |
getAttribute |
Получает значение заданного атрибута. |
int |
getAttributeCount() |
Возвращает количество атрибутов, определенных локально в этом наборе. |
Enumeration |
getAttributeNames() |
Возвращает перечисление имен атрибутов, определенных локально в наборе. |
AttributeSet |
getResolveParent() |
Возвращает разрешающий родитель. |
boolean |
isDefined |
Проверяет, имеет ли именованный атрибут значение, указанное в наборе, без разрешения через другой набор атрибутов. |
boolean |
isEqual |
Определяет, эквивалентны ли два набора атрибутов. |
Подробное описание полей
NameAttribute
static final Object NameAttribute
Имя атрибута, используемое для наименования коллекции атрибутов.
ResolveAttribute
static final Object ResolveAttribute
Имя атрибута, используемое для идентификации разрешающего родительского набора атрибутов, если он определен.
Подробное описание методов
getAttributeCount
int getAttributeCount()
Возвращает количество атрибутов, определенных локально в этом наборе. Атрибуты, определенные в родительском наборе, не включаются.
- Возвращает:
- количество атрибутов >= 0
isDefined
boolean isDefined(Object attrName)
Проверяет, имеет ли именованный атрибут значение, указанное в наборе, без разрешения через другой набор атрибутов.
- Параметры:
-
attrName- имя атрибута - Возвращает:
- true, если атрибут имеет указанное значение
isEqual
boolean isEqual(AttributeSet attr)
Определяет, эквивалентны ли два набора атрибутов.
- Параметры:
-
attr- набор атрибутов - Возвращает:
- true, если наборы эквивалентны
copyAttributes
AttributeSet copyAttributes()
Возвращает набор атрибутов, который гарантированно не изменится со временем.
- Возвращает:
- копию набора атрибутов
getAttribute
Object getAttribute(Object key)
Извлекает значение заданного атрибута. Если значение не найдено локально, поиск продолжается вверх по разрешающему родителю (если он существует), пока значение не будет найдено или больше нет родителей. Если значение не найдено, возвращается null.
- Параметры:
-
key- не нулевой ключ связи атрибута - Возвращает:
- значение атрибута или
null, если не найдено
getAttributeNames
Enumeration<?> getAttributeNames()
Возвращает перечисление имен атрибутов, определенных локально в наборе. Имена атрибутов, определенные в разрешающем родителе, если таковой имеется, не включаются. Значения
Enumeration могут быть любыми и не ограничены определенным типом Object. Этот метод никогда не возвращает null. Для набора без атрибутов он возвращает пустой Enumeration.
- Возвращает:
- имена
containsAttribute
boolean containsAttribute(Object name, Object value)
Возвращает
true, если этот набор определяет атрибут с тем же именем и равным значением. Если такой атрибут не найден локально, он ищется в иерархии разрешающих родителей.- Параметры:
-
name- не нулевое имя атрибута -
value- значение - Возвращает:
-
true, если набор определяет атрибут с равным значением, локально или через разрешающего родителя - Исключения:
-
NullPointerException- если либоname, либоvalueимеют значениеnull
containsAttributes
boolean containsAttributes(AttributeSet attributes)
Возвращает
true, если этот набор определяет все атрибуты из данного набора с равными значениями. Если атрибут не найден локально, он ищется в иерархии разрешающих родителей.- Параметры:
-
attributes- набор атрибутов для проверки - Возвращает:
-
true, если этот набор определяет все атрибуты с равными значениями, локально или через разрешающего родителя - Исключения:
-
NullPointerException- еслиattributesимеет значениеnull
getResolveParent
AttributeSet getResolveParent()
Возвращает разрешающего родителя.
- Возвращает:
- родителя
© 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/text/AttributeSet.html
