Интерфейс DocAttributeSet

Все суперинтерфейсы:: AttributeSet

Все известные реализующие классы:: HashDocAttributeSet

public interface DocAttributeSet extends AttributeSet

Интерфейс DocAttributeSet задаёт интерфейс для набора атрибутов документа, то есть атрибутов печати, реализующих интерфейс DocAttribute. В API службы печати клиент использует DocAttributeSet для указания характеристик отдельного документа и параметров задания печати, применяемых к этому документу.

DocAttributeSet — это просто AttributeSet, конструкторы и операции изменения которого гарантируют дополнительный инвариант: все значения атрибутов в DocAttributeSet должны быть экземплярами интерфейса DocAttribute. Операции add(Attribute) и addAll(AttributeSet) переопределены ниже, чтобы гарантировать этот дополнительный инвариант.

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

Модификатор и тип	Метод	Описание
`boolean`	`add(Attribute attribute)`	Добавляет указанное значение атрибута в этот набор атрибутов, если оно ещё не присутствует, предварительно удалив все существующие значения из той же категории атрибутов, что и указанное значение (необязательная операция).
`boolean`	`addAll(AttributeSet attributes)`	Добавляет все элементы указанного набора в этот набор атрибутов.

Методы, объявленные в интерфейсе AttributeSet

clear, containsKey, containsValue, equals, get, hashCode, isEmpty, remove, remove, size, toArray

Модификатор и тип	Метод	Описание
`void`	`clear()`	Удаляет все атрибуты из этого набора атрибутов.
`boolean`	`containsKey(Class<?> category)`	Возвращает `true`, если этот набор атрибутов содержит атрибут указанной категории.
`boolean`	`containsValue(Attribute attribute)`	Возвращает `true`, если этот набор атрибутов содержит указанное значение атрибута.
`boolean`	`equals(Object object)`	Сравнивает указанный объект с этим набором атрибутов на равенство.
`Attribute`	`get(Class<?> category)`	Возвращает значение атрибута, содержащееся в этом наборе атрибутов для указанной категории.
`int`	`hashCode()`	Возвращает хеш-код этого набора атрибутов.
`boolean`	`isEmpty()`	Возвращает `true`, если этот набор атрибутов не содержит атрибутов.
`boolean`	`remove(Class<?> category)`	Удаляет из этого набора атрибутов атрибут указанной категории, если он присутствует.
`boolean`	`remove(Attribute attribute)`	Удаляет указанный атрибут из этого набора атрибутов, если он присутствует.
`int`	`size()`	Возвращает количество атрибутов в этом наборе атрибутов.
`Attribute[]`	`toArray()`	Возвращает массив атрибутов, содержащихся в этом наборе.

Подробное описание методов

add

boolean add(Attribute attribute)

Добавляет указанное значение атрибута в этот набор атрибутов, если оно ещё не присутствует, предварительно удалив все существующие значения из той же категории атрибутов, что и указанное значение (необязательная операция).

Определено в:: add в интерфейсе AttributeSet
Параметры:: attribute — значение атрибута, добавляемое в этот набор атрибутов
Возвращает:: true, если в результате вызова этот набор атрибутов изменился, то есть указанное значение атрибута ещё не было элементом этого набора
Вызывает исключение:: UnmodifiableSetException — если этот набор атрибутов не поддерживает операцию add(); ClassCastException — если attribute не является экземпляром интерфейса DocAttribute; NullPointerException — если attribute имеет значение null

addAll

boolean addAll(AttributeSet attributes)

Добавляет все элементы указанного набора в этот набор атрибутов. Результат будет таким же, как если бы операция add(Attribute) последовательно применялась к этому набору атрибутов для каждого элемента указанного набора. Если ни одна из категорий указанного набора не совпадает с категориями этого набора атрибутов, операция addAll() фактически изменяет этот набор атрибутов так, что его значение становится объединением двух наборов.

Поведение операции addAll() не определено, если указанный набор изменяется во время выполнения операции.

Если операция addAll() вызывает исключение, влияние на состояние этого набора атрибутов зависит от реализации; элементы указанного набора, обработанные до возникновения исключения, могли быть добавлены в этот набор атрибутов, а могли и не быть.

Определено в:

addAll в интерфейсе AttributeSet

Параметры:

attributes — набор, элементы которого добавляются в этот набор атрибутов

Возвращает:

true, если в результате вызова этот набор атрибутов изменился

Вызывает исключение:

UnmodifiableSetException — если этот набор атрибутов не поддерживает метод addAll()

ClassCastException — если какой-либо элемент указанного набора не является экземпляром интерфейса DocAttribute

NullPointerException — если указанный набор имеет значение null

См. также:

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