Интерфейс AttributeSet

Все известные подинтерфейсы:: MutableAttributeSet, Style

Все известные реализующие классы:: AbstractDocument.AbstractElement, AbstractDocument.BranchElement, AbstractDocument.LeafElement, DefaultStyledDocument.SectionElement, HTMLDocument.BlockElement, HTMLDocument.RunElement, SimpleAttributeSet, StyleContext.NamedStyle, StyleContext.SmallAttributeSet

public interface AttributeSet

Коллекция уникальных атрибутов. Это интерфейс для чтения, неизменяемый. Атрибут — это, по сути, ключ и значение, назначенное этому ключу. Коллекция может представлять собой, например, набор стилей, логический стиль и т. д. Обычно они используются для описания функций, которые будут способствовать некоторому графическому представлению, например, шрифту. Набор возможных ключей не ограничен и может быть любым. Реализации представлений (View) обычно реагируют на определения атрибутов и отображают что-то для представления атрибутов.

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

См. также:: MutableAttributeSet

Вложенные классы

Модификатор и тип	Интерфейс и описание
`static interface`	`AttributeSet.CharacterAttribute` Этот интерфейс определяет сигнатуру, которая должна присутствовать у любого ключа атрибута, участвующего в представлении символов.
`static interface`	`AttributeSet.ColorAttribute` Этот интерфейс определяет сигнатуру, которая должна присутствовать у любого ключа атрибута, участвующего в представлении цвета.
`static interface`	`AttributeSet.FontAttribute` Этот интерфейс определяет сигнатуру, которая должна присутствовать у любого ключа атрибута, участвующего в определении шрифта для отображения текста.
`static interface`	`AttributeSet.ParagraphAttribute` Этот интерфейс определяет сигнатуру, которая должна присутствовать у любого ключа атрибута, участвующего в представлении абзаца.

Поля

Модификатор и тип	Поле и описание
`static Object`	`NameAttribute` Имя атрибута, используемое для именования коллекции атрибутов.
`static Object`	`ResolveAttribute` Имя атрибута, используемое для определения набора разрешающего родителя, если он определен.

Методы

Модификатор и тип	Метод и описание
`boolean`	`containsAttribute(Object name, Object value)` Возвращает `true` если этот набор определяет атрибут с таким же именем и равным значением.
`boolean`	`containsAttributes(AttributeSet attributes)` Возвращает `true` если этот набор определяет все атрибуты из заданного набора с равными значениями.
`AttributeSet`	`copyAttributes()` Возвращает набор атрибутов, гарантированно не изменяющийся со временем.
`Object`	`getAttribute(Object key)` Возвращает значение заданного атрибута.
`int`	`getAttributeCount()` Возвращает количество локально определенных атрибутов в этом наборе.
`Enumeration<?>`	`getAttributeNames()` Возвращает перечисление имен локально определенных атрибутов в наборе.
`AttributeSet`	`getResolveParent()` Получает разрешающего родителя.
`boolean`	`isDefined(Object attrName)` Проверяет, имеет ли именованный атрибут значение, указанное в наборе, без разрешения через другой набор атрибутов.
`boolean`	`isEqual(AttributeSet attr)` Определяет, эквивалентны ли два набора атрибутов.

Поля

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, 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.