Интерфейс 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)`	Добавляет все элементы из указанного набора в этот атрибут.

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

clear, containsKey, containsValue, equals, get, hashCode, isEmpty, remove, remove, size, 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/print/attribute/DocAttributeSet.html