Пакет javax.print.attribute.standard

Пакет javax.print.attribute.standard содержит классы для определенных атрибутов печати.

См.: Описание

Сводка класса

Класс	Описание
Цветность	Цветность класса является классом атрибута печати, перечислением, которое определяет монохром или цветную печать.
ColorSupported	ColorSupported класса является классом атрибута печати, перечислением, которое идентифицирует, способно ли устройство к какому-либо типу печати цвета вообще, включая выделение цветной так же как полный смесевой цвет.
Сжатие	Сжатие класса является классом атрибута печати, перечислением, которое определяет, как данные печати сжимаются.
Копии	Копии класса являются целым числом, оцененным, печатая класс атрибута, который определяет число копий, которые будут напечатаны.
CopiesSupported	CopiesSupported класса является классом атрибута печати, ряд целых чисел, который дает поддерживаемые значения для a Copies атрибут.
DateTimeAtCompleted	DateTimeAtCompleted класса является классом атрибута печати, разовым датой атрибутом, который указывает на дату и время, в которое завершенное Задание Печати (или был отменен или прерывался).
DateTimeAtCreation	DateTimeAtCreation класса является классом атрибута печати, разовым датой атрибутом, который указывает на дату и время, в которое создавалось Задание Печати.
DateTimeAtProcessing	DateTimeAtProcessing класса является классом атрибута печати, разовым датой атрибутом, который указывает на дату и время, в которое Задание Печати сначала начало обрабатывать.
Место назначения	Место назначения класса является классом атрибута печати, URI, который используется, чтобы указать на альтернативное место назначения для spooled принтера отформатированные данные.
DialogTypeSelection	DialogTypeSelection класса является классом атрибута печати, перечислением, которое указывает на пользовательский диалоговый тип, который будет использоваться для того, чтобы определить параметры печати.
DocumentName	DocumentName класса является классом атрибута печати, текстовым атрибутом, который определяет имя документа.
Точность	Точность класса является классом атрибута печати, требуется перечисление, которое указывает, приписывает ли полная точность клиенту предоставленный запрос печати.
Finishings	Finishings класса является классом атрибута печати, перечислением, которое идентифицирует, применяет ли принтер заканчивающуюся работу некоторой привязки с каждой копией каждого печатного документа на задании.
JobHoldUntil	JobHoldUntil класса является классом атрибута печати, разовым датой атрибутом, который определяет точную дату и время, в которое задание должно стать кандидатом на печать.
JobImpressions	JobImpressions класса является целым числом, оцененным, печатая класс атрибута, который определяет полный размер в числе впечатлений от представляемого документа (ов).
JobImpressionsCompleted	JobImpressionsCompleted класса является целым числом, оцененным, печатая класс атрибута, который определяет число впечатлений, завершенных для задания до сих пор.
JobImpressionsSupported	JobImpressionsSupported класса является классом атрибута печати, ряд целых чисел, который дает поддерживаемые значения для a JobImpressions атрибут.
JobKOctets	JobKOctets класса является целым числом, оцененным, печатая класс атрибута, который определяет полный размер документа (ов) в K октетов, то есть, в модулях 1024 октетов, которые требуют быть обработанными на задании.
JobKOctetsProcessed	JobKOctetsProcessed класса является целым числом, оцененным, печатая класс атрибута, который определяет общее количество октетов данных печати, обрабатываемых до сих пор в K октетов, то есть, в модулях 1024 октетов.
JobKOctetsSupported	JobKOctetsSupported класса является классом атрибута печати, ряд целых чисел, который дает поддерживаемые значения для a JobKOctets атрибут.
JobMediaSheets	JobMediaSheets класса является целым числом, оцененным, печатая класс атрибута, который определяет общее количество листов носителей, которые будут произведены для этого задания.
JobMediaSheetsCompleted	JobMediaSheetsCompleted класса является целым числом, оцененным, печатая класс атрибута, который определяет число листов носителей, которые завершили маркировку и укладку для всего задания до сих пор, были ли те листы обработаны на одной стороне или на обоих.
JobMediaSheetsSupported	JobMediaSheetsSupported класса является классом атрибута печати, ряд целых чисел, который дает поддерживаемые значения для a JobMediaSheets атрибут.
JobMessageFromOperator	JobMessageFromOperator класса является классом атрибута печати, текстовым атрибутом, который обеспечивает сообщение от оператора, системного администратора, или "интеллектуального" процесса, чтобы указать до конца на пользователя причины модификации или другого действия управления, полученного задание.
JobName	JobName класса является классом атрибута печати, текстовым атрибутом, который определяет имя задания печати.
JobOriginatingUserName	JobOriginatingUserName класса является классом атрибута печати, текстовым атрибутом, который содержит имя конечного пользователя, который представил задание печати.
JobPriority	JobPriority класса является целым числом, оцененным, печатая класс атрибута, который определяет приоритет задания печати.
JobPrioritySupported	JobPrioritySupported класса является целым числом, оцененным, печатая класс атрибута, который определяет, поддерживает ли экземпляр Службы печати JobPriority атрибут и число различных приоритетных уровней задания поддерживаются.
JobSheets	Класс JobSheets является классом атрибута печати, перечислением, которое определяет, какое задание запускается и форзацы, если таковые вообще имеются, должен быть напечатан с заданием.
JobState	JobState является классом атрибута печати, перечислением, которое идентифицирует текущее состояние задания печати.
Джобстэтерисон	Джобстэтерисон класса является классом атрибута печати, перечислением, которое обеспечивает дополнительную информацию о текущем состоянии задания, то есть, информация, которая увеличивает значение задания JobState атрибут.
JobStateReasons	JobStateReasons класса является классом атрибута печати, ряд перечислимых величин, который обеспечивает дополнительную информацию о текущем состоянии задания, то есть, информация, которая увеличивает значение задания JobState атрибут.
Носители	Носители класса являются классом атрибута печати, который определяет носитель, на котором можно напечатать.
MediaName	MediaName класса является подклассом Носителей, класс атрибута печати (перечисление), который определяет носители для задания печати как имя.
MediaPrintableArea	Класс MediaPrintableArea является атрибутом печати, используемым, чтобы отличить печатаемые и непечатаемые области носителей.
MediaSize	MediaSize класса является двумерным размером, оцененным, печатая класс атрибута, который указывает на размерности носителя в портретной ориентации с X размерностями, работающими вдоль базового края и размерности Y, работающей вдоль левого края.
MediaSize. Разработка	Класс MediaSize. Разработка включает MediaSize значения для технических носителей.
MediaSize. ISO	Класс MediaSize. ISO включает MediaSize значения для носителей ISO.
MediaSize. JIS	Класс MediaSize. JIS включает MediaSize значения для JIS (японский язык) носители.
MediaSize. NA	Класс MediaSize. NA включает MediaSize значения для североамериканских носителей.
MediaSize. Другой	Класс MediaSize. Другой включает MediaSize значения для разных носителей.
MediaSizeName	Класс MediaSizeName является подклассом Носителей.
MediaTray	Класс MediaTray является подклассом Носителей.
MultipleDocumentHandling	MultipleDocumentHandling класса является классом атрибута печати, перечислением, которое управляет заканчивающимися операциями и размещением одной или более страниц потока печати во впечатления и на листы носителей.
NumberOfDocuments	Класс NumberOfDocuments является целым числом, оцененным, печатая атрибут, который указывает на число отдельных документов принтер, принял для этого задания, независимо от того, достигли ли данные печати документов принтера или нет.
NumberOfInterveningJobs	NumberOfInterveningJobs класса является целым числом, оцененным, печатая атрибут, который указывает на число заданий, которые являются перед этим заданием в относительном хронологическом порядке ожидаемого времени завершиться (то есть, ток запланированный порядок).
NumberUp	NumberUp класса является целым числом, оцененным, печатая класс атрибута, который определяет число страниц потока печати, чтобы наложить на единственную сторону экземпляра выбранного носителя.
NumberUpSupported	NumberUpSupported класса является классом атрибута печати, ряд целых чисел, который дает поддерживаемые значения для a NumberUp атрибут.
OrientationRequested	OrientationRequested класса является классом атрибута печати, перечислением, которое указывает на требуемую ориентацию для печатных страниц потока печати; это не описывает ориентацию предоставленных клиентом страниц потока печати.
OutputDeviceAssigned	OutputDeviceAssigned класса является классом атрибута печати, текстовым атрибутом, который идентифицирует устройство вывода, которому служба присвоила это задание.
PageRanges	PageRanges класса является классом атрибута печати, ряд целых чисел, который идентифицирует диапазон (ы) страниц потока печати, которые объект Принтера использует для каждой копии каждого документа, которые должны быть напечатаны.
PagesPerMinute	PagesPerMinute класса является целым числом, оцененным, печатая атрибут, который указывает на номинальное число страниц в минуту к самому близкому целому числу, которое может быть сгенерировано этим принтером (например, симплекс, черно-белый).
PagesPerMinuteColor	PagesPerMinuteColor класса является целым числом, оцененным, печатая атрибут, который указывает на номинальное число страниц в минуту к самому близкому целому числу, которое может быть сгенерировано этим принтером, печатая цвет (например, симплекс, цвет).
PDLOverrideSupported	PDLOverrideSupported класса является классом атрибута печати, перечислением, которое выражает возможность принтера попытаться переопределить инструкции обработки, встроенные в данные печати документов с обработкой инструкций, определенных как атрибуты вне данных печати.
PresentationDirection	PresentationDirection класса является классом атрибута печати, перечислением, которое используется в соединении с NumberUp атрибут, чтобы указать на расположение многократных страниц потока печати, чтобы наложить на единственную сторону экземпляра выбранного носителя.
PrinterInfo	PrinterInfo класса является классом атрибута печати, текстовым атрибутом, который предоставляет дескриптивную информацию о принтере.
PrinterIsAcceptingJobs	PrinterIsAcceptingJobs класса является классом атрибута печати, перечислением, которое указывает, ли принтер в настоящий момент в состоянии принять задания.
PrinterLocation	PrinterLocation класса является классом атрибута печати, текстовым атрибутом, который идентифицирует расположение устройства.
PrinterMakeAndModel	Класс PrinterMakeAndModel является классом атрибута печати, текстовым атрибутом, что делать и модель принтера.
PrinterMessageFromOperator	PrinterMessageFromOperator класса является классом атрибута печати, текстовым атрибутом, который обеспечивает сообщение от оператора, системного администратора, или "интеллектуального" процесса, чтобы указать до конца на информацию о пользователе об или состояние принтера, такой как, почему это недоступно или когда это, как ожидают, будет доступно.
PrinterMoreInfo	PrinterMoreInfo класса является классом атрибута печати, URI, который используется, чтобы получить больше информации об этом определенном принтере.
PrinterMoreInfoManufacturer	PrinterMoreInfoManufacturer класса является классом атрибута печати, URI, который используется, чтобы получить больше информации об этом типе устройства.
PrinterName	PrinterName класса является классом атрибута печати, текстовым атрибутом, который определяет имя принтера.
PrinterResolution	PrinterResolution класса является классом атрибута печати, который определяет точное разрешение, поддерживаемое принтером или использоваться для задания печати.
PrinterState	PrinterState класса является классом атрибута печати, перечислением, которое идентифицирует текущее состояние принтера.
Принтерстэтерисон	Принтерстэтерисон класса является классом атрибута печати, перечислением, которое обеспечивает дополнительную информацию о текущем состоянии принтера, то есть, информация, которая увеличивает значение принтера PrinterState атрибут.
PrinterStateReasons	PrinterStateReasons класса является классом атрибута печати, ряд перечислимых величин, который обеспечивает дополнительную информацию о текущем состоянии принтера, то есть, информация, которая увеличивает значение принтера PrinterState атрибут.
PrinterURI	PrinterURI класса является классом атрибута печати, URI, который определяет глобально уникальное имя принтера.
PrintQuality	PrintQuality класса является классом атрибута печати, перечислением, которое определяет качество печати, которое принтер использует для задания.
QueuedJobCount	QueuedJobCount класса является целым числом, оцененным, печатая атрибут, который указывает на число заданий в принтере чей JobState или ОЖИДАЕТ, PENDING_HELD, ОБРАБОТКА, или PROCESSING_STOPPED.
ReferenceUriSchemesSupported	Класс ReferenceUriSchemesSupported является атрибутом печати, классифицирует перечисление, которое указывает на "схему URI," такой как "http:" или "протокол передачи файлов:", то, что принтер может использовать, чтобы получить данные печати, хранившие в расположении URI.
RequestingUserName	RequestingUserName класса является классом атрибута печати, текстовым атрибутом, который определяет имя конечного пользователя, который представил задание печати.
Серьезность	Серьезность класса является классом атрибута печати, перечислением, которое обозначает серьезность a PrinterStateReason атрибут.
SheetCollate	SheetCollate класса является классом атрибута печати, перечислением, которое определяет, должны ли листы носителей каждой копии каждого печатного документа на задании быть в последовательности, когда многократные копии документа определяются Copies атрибут.
Стороны	Стороны класса являются классом атрибута печати, перечислением, которое определяет, как страницы потока печати должны быть наложены на стороны экземпляра выбранного носителя, то есть, впечатление.

Пакет javax.print.attribute.standard Описание

Пакет javax.print.attribute.standard содержит классы для определенных атрибутов печати. Родительский пакет, javax.print.attribute, обеспечивает классы и интерфейсы, которые описывают типы атрибутов Службы печати Java и как они могут быть собраны в наборы атрибута.

Атрибут представляет функцию печати, которую может обеспечить служба печати. Для каждого атрибута служба печати или делает или не поддерживает атрибут. Для каждого возможного значения поддерживаемого атрибута служба печати или делает или не поддерживает значение.

API требует, чтобы каждая служба печати поддерживала определенные атрибуты; другие атрибуты являются дополнительными, и служба может выбрать, поддерживать ли их. У каждого атрибута есть ряд значений, которые это принимает. API требует, чтобы каждая служба печати поддерживала определенные значения для определенных атрибутов; другие значения атрибута являются дополнительными, и служба может выбрать, поддерживать ли их. Эти требования поддержки записываются в документации для каждого класса атрибута.

Пакет javax.print.attribute.standard содержит стандартные атрибуты печати и стандартные значения атрибута печати, которые широко используются в домене печати. Поставщик службы печати может обеспечить новые специфичные для поставщика атрибуты печати в дополнение к стандартным. Поставщик может также обеспечить специфичные для поставщика расширения (подклассы) стандартных атрибутов печати - например, чтобы обеспечить дополнительные специфичные для поставщика значения для существующего стандартного атрибута. Конечно, если поставщик хочет, чтобы клиенты были в состоянии использовать какие-либо добавленные или расширенные атрибуты, поставщик должен опубликовать новые классы атрибута.

Многие из стандартных классов атрибута расширяют один из классов абстрактного синтаксиса javax.print.attribute пакета. Эти классы абстрактного синтаксиса каждый представляет различный тип. Класс EnumSyntax, например, представляет безопасное с точки зрения типов перечисление. Класс абстрактного синтаксиса обеспечивает обертку для значения атрибута.

Если класс атрибута расширяется EnumSyntax, и значение атрибута является IPP-совместимым значением, атрибут toString метод возвращает строковое представление IPP значения атрибута, такой как "остановлено обработкой" для атрибута JobState. Однако, потому что EnumSyntax класс расширяем, поставщики могут определить свои собственные значения атрибута. Если атрибут использует EnumSyntax класс и устанавливается в одно из этих определенных поставщиком значений тогда toString метод не будет возвращать строковое представление IPP значения.

Клиентское приложение печати не должно будет обычно использовать все классы атрибута печати в пакете javax.print.attribute.standard, только те, которые принадлежат приложению.

Классы атрибута в пакете javax.print.attribute.standard основаны на интернет-Протоколе Печати (IPP) атрибуты как определено в интернет-документе RFC, интернет-Протоколе/1.1 Печати RFC 2911: Модель и Семантика, датированная сентябрем 2000. См. RFC 2911 для получения дополнительной информации. Дескриптивный текст для каждого класса атрибута был взят в значительной степени из вышеупомянутых документов. Содействие вышеупомянутых авторов API с благодарностью подтверждается.

Организация атрибута

Есть пять видов печати атрибутов: атрибуты документа, атрибуты запроса печати, печатают атрибуты задания, атрибуты службы печати, и атрибуты поддерживаемых значений.

Атрибуты документа

Атрибуты документа определяют характеристики отдельного документа и настроек задания печати, которые будут применены к отдельному документу. Класс атрибута документа реализует интерфейсный DocAttribute. Атрибут документа может появиться в DocAttributeSet.

Атрибуты Запроса печати

Атрибуты запроса печати определяют настройки, которые будут применены к целому заданию печати и ко всем документам на задании печати. Класс атрибута запроса печати реализует интерфейсный PrintRequestAttribute. Атрибут запроса печати может появиться в PrintRequestAttributeSet.

Некоторые атрибуты являются атрибутами документа, но не печатают атрибуты запроса и могут только быть определены на уровне документа. Некоторые атрибуты являются атрибутами запроса печати, но не атрибутами документа и могут только быть определены на уровне Запроса Печати. Некоторые атрибуты являются и атрибутами документа и печатают атрибуты запроса и могут быть определены или на уровне документа или на уровне Запроса Печати.

Когда определено на уровне документа, атрибут применяется только к тому одному документу. Когда определено на уровне Запроса Печати, атрибут применяется к целому заданию, включая все документы на задании. Однако, атрибут, определенный на уровне документа, переопределяет атрибут в той же самой категории, определенной на уровне Запроса Печати.

Атрибуты Задания печати

Атрибуты задания печати сообщают о состоянии Задания Печати. Класс атрибута задания печати реализует интерфейсный PrintJobAttribute. Атрибут задания печати может появиться в PrintJobAttributeSet.

Некоторые атрибуты являются и атрибутами запроса печати и печатают атрибуты задания; клиент может включать такие атрибуты в Запрос Печати, чтобы определить характеристики для следующего Задания Печати, и те атрибуты тогда также появляются в наборе атрибута Задания Печати. Некоторые атрибуты являются атрибутами задания печати, но не печатают атрибуты запроса; сама служба печати добавляет эти атрибуты к набору атрибута Задания Печати.

Атрибуты Службы печати

Атрибуты службы печати сообщают о состоянии службы печати. Класс атрибута службы печати реализует интерфейсный PrintServiceAttribute. Атрибут службы печати может появиться в PrintServiceAttributeSet.

Атрибуты поддерживаемых значений

Атрибут поддерживаемого значения указывает на юридические значения для другого атрибута, который поддерживает служба печати. Поддерживаемые значения приписывают интерфейс реализаций класса SupportedValuesAttribute. Однако, атрибуты поддерживаемых значений никогда не появляются в наборах атрибута, таким образом есть не ограниченный подынтерфейс AttributeSet для них.

Таблица атрибутов

Таблица ниже приводит все атрибуты печати. Таблица показывает, что тегирование соединяет интерфейсом с каждым классом атрибута реализации, кроме того, чтобы соединить интерфейсом с Атрибутом, таким образом указывая, как каждый атрибут используется в API. Для каждого атрибута документа и атрибута запроса печати, столбец отмеченный "SupportedValuesAttribute" перечисляет класс атрибута поддерживаемых значений, если таковые вообще имеются, с которым служба печати указывает на поддерживаемые значения для той категории атрибута.

Класс атрибута	Документ Атрибут	Печать Запрос Атрибут	Печать Задание Атрибут	Печать Служба Атрибут	SupportedValuesAttribute
Сжатие	X
DocumentName	X
Цветность	X	X	X
Копии		X	X		CopiesSupported
Finishings	X	X	X
JobHoldUntil		X	X
JobImpressions		X	X		JobImpressionsSupported
JobKOctets		X	X		JobKOctetsSupported
JobMediaSheets		X	X		JobMediaSheetsSupported
JobName		X	X
JobPriority		X	X		JobPrioritySupported
JobSheets		X	X
Носители	X	X	X
MediaSize
MultipleDocumentHandling		X	X
NumberUp	X	X	X		NumberUpSupported
OrientationRequested	X	X	X
PageRanges	X	X	X
PresentationDirection	X	X	X
PrinterResolution	X	X	X
PrintQuality	X	X	X
RequestingUserName		X	X
SheetCollate	X	X	X
Стороны	X	X	X
DateTimeAtCompleted			X
DateTimeAtCreation			X
DateTimeAtProcessing			X
JobImpressionsCompleted			X
JobKOctetsProcessed			X
JobMediaSheetsCompleted			X
JobMessageFromOperator			X
JobOriginatingUserName			X
JobState			X
JobStateReasons Содержит нуль или более-			X
-- Джобстэтерисон
NumberOfDocuments			X
NumberOfInterveningJobs			X
OutputDeviceAssigned			X
ColorSupported				X
PagesPerMinute				X
PagesPerMinuteColor				X
PDLOverrideSupported				X
PrinterIsAcceptingJobs				X
PrinterInfo				X
PrinterLocation				X
PrinterMessageFromOperator				X
PrinterMakeAndModel				X
PrinterMoreInfo				X
PrinterMoreInfoManufacturer				X
PrinterName				X
PrinterState				X
PrinterStateReasons Содержит нуль или более-				X
-- Принтерстэтерисон
-- Серьезность
QueuedJobCount				X
ReferenceUriSchemesSupported

Пожалуйста, отметьте: В javax.print API нулевой ссылочный параметр к методам является неправильным если явно не задокументировано на методе как наличие значимой интерпретации. Использование наоборот является неправильным кодированием и может привести к исключению времени выполнения или сразу или в некоторое более позднее время. IllegalArgumentException и NullPointerException являются примерами типичных и приемлемых исключений времени выполнения для таких случаев.

С тех пор:

1.4