Интерфейс 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. - См. также:
add(Attribute)
© 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.