javax.print.attribute

Интерфейс AttributeSet

Все Известные Подынтерфейсы:

DocAttributeSet, PrintJobAttributeSet, PrintRequestAttributeSet, PrintServiceAttributeSet

Все Известные Классы с реализацией:

HashAttributeSet, HashDocAttributeSet, HashPrintJobAttributeSet, HashPrintRequestAttributeSet, HashPrintServiceAttributeSet

public interface AttributeSet

Интерфейс AttributeSet определяет интерфейс для ряда атрибутов печати. Атрибут печати является объектом, class которого реализует интерфейс Attribute.

Набор атрибута содержит группу значений атрибута, где двойные значения не позволяются в наборе. Кроме того каждое значение в наборе атрибута является элементом некоторой категории, и самое большее одно значение в любой определенной категории позволяется в наборе. Для набора атрибута значения Attribute объекты, и категории Class объекты. Категорией атрибута является class (или интерфейс) в корне иерархии class для такого атрибута. Отметьте, что категория объекта атрибута может быть суперклассом объекта атрибута class, а не объект атрибута class непосредственно. Категория объекта атрибута определяется, вызывая getCategory() метод определяется в интерфейсе Attribute.

Интерфейсы AttributeSet напоминают таковые из java.util API Наборов Java. Интерфейс карты, но является более рестриктивным в типах, которые он примет, и комбинирует ключи и значения в Атрибут.

Наборы атрибута используются в нескольких местах в API Службы печати. В каждом контексте только определенным видам атрибутов позволяют появиться в наборе атрибута, как определено интерфейсами тегирования который атрибут реализации class- DocAttribute, PrintRequestAttribute, PrintJobAttribute, и PrintServiceAttribute. Есть четыре специализации набора атрибута, которые ограничиваются, чтобы содержать только один из четырех видов атрибута- DocAttributeSet, PrintRequestAttributeSet, PrintJobAttributeSet, и PrintServiceAttributeSet, соответственно. Отметьте, что много классов атрибута реализуют больше чем один интерфейс тегирования и так могут появиться больше чем в одном контексте.

• A DocAttributeSet, содержа DocAttributes, определяет характеристики отдельного документа и настроек задания печати, которые будут применены к отдельному документу.

• A PrintRequestAttributeSet, содержа PrintRequestAttributes, определяет настройки, которые будут применены к целому заданию печати и ко всем документам на задании печати.

• A PrintJobAttributeSet, содержа PrintJobAttributes, сообщает состояние задания печати.

• A PrintServiceAttributeSet, содержа PrintServiceAttributes, сообщает состояние экземпляра Службы печати.

В некоторых контекстах клиенту только разрешают исследовать атрибут содержание набора, но не изменить их (набор только для чтения). В других местах клиенту разрешают и исследовать и изменить атрибут содержание набора (набор является чтением-записью). Для набора атрибута "только для чтения", вызывая видоизменяющуюся работу бросает UnmodifiableSetException.

API Службы печати обеспечивает одну реализацию интерфейса AttributeSet, class HashAttributeSet. Клиент может использовать class HashAttributeSet или обеспечьте его собственную реализацию интерфейса AttributeSet. API Службы печати также обеспечивает реализации подынтерфейсов AttributeSet интерфейса - классы HashDocAttributeSet, HashPrintRequestAttributeSet, HashPrintJobAttributeSet, и HashPrintServiceAttributeSet.

Сводка метода

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

Деталь метода

добраться

Attribute get(Class<?> category)

Возвращает значение атрибута, которое этот набор атрибута содержит в данной категории атрибута. null возвратов, если этот набор атрибута не содержит значения атрибута в данной категории атрибута.

Параметры:

category - Категория атрибута, связанное значение атрибута которой должно быть возвращено. Это должен быть a Class это реализует интерфейс Attribute.

Возвраты:

Значение атрибута в данной категории атрибута, содержавшейся в этом наборе атрибута, или null, если этот набор атрибута не содержит значения атрибута в данной категории атрибута.

Броски:

NullPointerException - (исключение непроверенное) Брошенный, если category нуль.

ClassCastException - (исключение непроверенное) Брошенный, если category не a Class это реализует интерфейс Attribute.

добавить

boolean add(Attribute attribute)

Добавляет указанный атрибут к этому набору атрибута, если это уже не существует, сначала удаляя какое-либо существующее значение в той же самой категории атрибута как указанное значение атрибута.

Параметры:

attribute - Значение атрибута, которое будет добавлено к этому набору атрибута.

Возвраты:

true, если этот набор атрибута, измененный в результате вызова, то есть, данное значение атрибута уже не было элементом этого набора атрибута.

Броски:

NullPointerException - (исключение непроверенное) Брошенный, если attribute нуль.

UnmodifiableSetException - (исключение непроверенное) Брошенный, если этот набор атрибута не поддерживает add() работа.

удалить

boolean remove(Class<?> category)

Удаляет любой атрибут для этой категории от этого набора атрибута если существующий. Если category нуль, тогда remove() ничего не делает и возвращает false.

Параметры:

category - Категория атрибута, которая будет удалена из этого набора атрибута.

Возвраты:

true, если этот набор атрибута, измененный в результате вызова, то есть, данное значение атрибута было элементом этого набора атрибута.

Броски:

UnmodifiableSetException - (исключение непроверенное) Брошенный, если этот набор атрибута не поддерживает remove() работа.

удалить

boolean remove(Attribute attribute)

Удаляет указанный атрибут из этого набора атрибута если существующий. Если attribute нуль, тогда remove() ничего не делает и возвращает false.

Параметры:

attribute - Значение атрибута, которое будет удалено из этого набора атрибута.

Возвраты:

true, если этот набор атрибута, измененный в результате вызова, то есть, данное значение атрибута было элементом этого набора атрибута.

Броски:

UnmodifiableSetException - (исключение непроверенное) Брошенный, если этот набор атрибута не поддерживает remove() работа.

containsKey

boolean containsKey(Class<?> category)

true возвратов, если этот набор атрибута содержит атрибут для указанной категории.

Параметры:

category - чье присутствие в этом наборе атрибута должно быть протестировано.

Возвраты:

true, если этот набор атрибута содержит значение атрибута для указанной категории.

containsValue

boolean containsValue(Attribute attribute)

true возвратов, если этот набор атрибута содержит данное значение атрибута.

Параметры:

attribute - Значение атрибута, присутствие которого в этом наборе атрибута должно быть протестировано.

Возвраты:

true, если этот набор атрибута содержит данное значение атрибута.

addAll

boolean addAll(AttributeSet attributes)

Добавляют все элементы в указанном наборе к этому атрибуту. Результатом является то же самое как будто = add(Attribute) работа была применена к этому набору атрибута последовательно с каждым элементом от указанного набора. Поведение addAll(AttributeSet) работа является неуказанной, если указанный набор изменяется, в то время как работа происходит.

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

Параметры:

attributes - чьи элементы должны быть добавлены к этому набору атрибута.

Возвраты:

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

Броски:

UnmodifiableSetException - (Исключение непроверенное) Брошенный, если этот набор атрибута не поддерживает метод addAll(AttributeSet).

NullPointerException - (Исключение непроверенное) Брошенный, если некоторый элемент в указанном наборе является нулем.

См. Также:

add(Attribute)

размер

int size()

Возвращает число атрибутов в этом наборе атрибута. Если этот набор атрибута содержит больше чем элементы Integer.MAX_VALUE, Integer.MAX_VALUE возвратов.

Возвраты:

Номер атрибутов в этом атрибуте определяется.

toArray

Attribute[] toArray()

Возвращает массив атрибутов, содержавшихся в этом наборе.

Возвраты:

Атрибуты, содержавшиеся в этом наборе как массив, обнулите длину, если AttributeSet пуст.

очистить

void clear()

Удаляет все атрибуты из этого набора атрибута.

Броски:

UnmodifiableSetException - (исключение непроверенное) Брошенный, если этот набор атрибута не поддерживает clear() работа.

isEmpty

boolean isEmpty()

Возвращает true, если этот набор атрибута не содержит атрибутов.

Возвраты:

истина, если этот набор атрибута не содержит атрибутов.

равняется

boolean equals(Object object)

Сравнивает указанный объект с этим набором атрибута для равенства. Возвраты true, если данный объект является также набором атрибута и двумя наборами атрибута, содержат те же самые отображения значения атрибута категории атрибута. Это гарантирует, что метод equals() работает должным образом через различные реализации интерфейса AttributeSet.

Переопределения:

equals в class Object

Параметры:

object - быть сравненным для равенства с этим набором атрибута.

Возвраты:

true, если указанный объект равен этому набору атрибута.

См. Также:

Object.hashCode(), HashMap

хэш-код

int hashCode()

Возвращает значение хэш-кода для этого набора атрибута. Хэш-код набора атрибута определяется, чтобы быть суммой хэш-кодов каждой записи в AttributeSet. Это гарантирует, что t1.equals(t2) подразумевает что t1.hashCode()==t2.hashCode() для любых двух наборов атрибута t1 и t2, как требуется согласно общему контракту Object.hashCode().

Переопределения:

hashCode в class Object

Возвраты:

Значение хэш-кода для этого атрибута устанавливается.

См. Также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)