Spec-Zone.ru › OpenJDK 8

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

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

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

Класс Описание
Хроматичность

Класс Chromaticity — это класс атрибутов печати, перечисление, которое определяет монохромную или цветную печать.

ColorSupported

Класс ColorSupported — это класс атрибутов печати, перечисление, которое определяет, способен ли устройство на печать любого типа цвета, включая цвет выделения и полноцветную печать.

Сжатие

Класс Compression — это класс атрибутов печати, перечисление, которое определяет способ сжатия данных печати.

Копии

Класс Copies — это целочисленный класс атрибутов печати, который определяет количество копий для печати.

CopiesSupported

Класс CopiesSupported — это класс атрибутов печати, набор целых чисел, который предоставляет поддерживаемые значения для атрибута Copies.

ДатаВремяЗавершения

Класс DateTimeAtCompleted — это класс атрибутов печати, атрибут даты и времени, который указывает дату и время завершения задания печати (или его отмены или прерывания).

ДатаВремяСоздание

Класс DateTimeAtCreation — это класс атрибутов печати, атрибут даты и времени, который указывает дату и время создания задания печати.

ДатаВремяОбработки

Класс DateTimeAtProcessing — это класс атрибутов печати, атрибут даты и времени, который указывает дату и время, когда задание печати началось обработку.

Местоназначения

Класс Destination — это класс атрибутов печати, URI, который используется для указания альтернативного места назначения для данных, отформатированных принтером.

ВыборТипаДиалога

Класс DialogTypeSelection — это класс атрибутов печати, перечисление, которое указывает тип диалога пользователя для задания параметров печати.

ИмяДокумента

Класс DocumentName — это класс атрибутов печати, текстовый атрибут, который определяет имя документа.

Точность

Класс Fidelity — это класс атрибутов печати, перечисление, которое указывает, требуется ли полная точность атрибутов запроса на печать, предоставленных клиентом.

ОтделочныеРаботы

Класс Finishings — это класс атрибутов печати, перечисление, которое определяет, применяет ли принтер операцию отделки какого-либо вида переплета к каждой копии каждого напечатанного документа в задании.

ЗадержкаЗаданияДо

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

ОтпечаткиЗадания

Класс JobImpressions — это целочисленный класс атрибутов печати, который определяет общий размер в количестве отпечатков документа(ов), отправляемого.

ОтпечаткиЗаданияЗавершенные

Класс JobImpressionsCompleted — это целочисленный класс атрибутов печати, который определяет количество завершенных отпечатков для задания на данный момент.

ПоддерживаемыеОтпечаткиЗадания

Класс JobImpressionsSupported — это класс атрибутов печати, набор целых чисел, который предоставляет поддерживаемые значения для атрибута JobImpressions.

ЗаданиеKOктеты

Класс JobKOctets — это целочисленный класс атрибутов печати, который определяет общий размер документа(ов) в К октетах, т. е. в единицах по 1024 октета, запрошенных для обработки в задании.

ОбработанныеЗаданияKOктеты

Класс JobKOctetsProcessed — это целочисленный класс атрибутов печати, который определяет общее количество обработанных октетов данных печати до сих пор в К октетах, т. е. в единицах по 1024 октета.

ПоддерживаемыеЗаданияKOктеты

Класс JobKOctetsSupported — это класс атрибутов печати, набор целых чисел, который предоставляет поддерживаемые значения для атрибута JobKOctets.

ЛистыМедиаЗадания

Класс JobMediaSheets — это целочисленный класс атрибутов печати, который определяет общее количество листов носителя, которые должны быть созданы для этого задания.

ЗавершенныеЛистыМедиаЗадания

Класс JobMediaSheetsCompleted — это целочисленный класс атрибутов печати, который определяет количество листов носителя, которые завершили маркировку и укладку для всего задания на данный момент, независимо от того, были ли эти листы обработаны с одной или обеих сторон.

ПоддерживаемыеЛистыМедиаЗадания

Класс JobMediaSheetsSupported — это класс атрибутов печати, набор целых чисел, который предоставляет поддерживаемые значения для атрибута JobMediaSheets.

СообщениеОператораЗадания

Класс JobMessageFromOperator — это класс атрибутов печати, текстовый атрибут, который предоставляет сообщение от оператора, системного администратора или «интеллектуального» процесса, чтобы указать конечному пользователю причины изменения или других действий по управлению заданием.

ИмяЗадания

Класс JobName — это класс атрибутов печати, текстовый атрибут, который определяет имя задания печати.

ИмяПользователяИсходногоЗадания

Класс JobOriginatingUserName — это класс атрибутов печати, текстовый атрибут, который содержит имя конечного пользователя, который отправил задание печати.

ПриоритетЗадания

Класс JobPriority — это целочисленный класс атрибутов печати, который определяет приоритет задания печати.

ПоддерживаемыйПриоритетЗадания

Класс JobPrioritySupported — это целочисленный класс атрибутов печати, который определяет, поддерживает ли экземпляр службы печати атрибут JobPriority и количество различных уровней приоритета заданий.

ЛистыЗадания

Класс JobSheets — это класс атрибутов печати, перечисление, которое определяет, какие листы начала и конца задания, если таковые имеются, должны быть напечатаны с заданием.

СостояниеЗадания

JobState — это класс атрибутов печати, перечисление, которое идентифицирует текущее состояние задания печати.

ПричинаСостоянияЗадания

Класс JobStateReason — это класс атрибутов печати, перечисление, которое предоставляет дополнительную информацию о текущем состоянии задания, т. е. информацию, которая дополняет значение атрибута задания JobState.

ПричиныСостоянияЗадания

Класс JobStateReasons — это класс атрибутов печати, набор значений перечисления, которые предоставляют дополнительную информацию о текущем состоянии задания, т. е. информацию, которая дополняет значение атрибута задания JobState.

Носитель

Класс Media — это класс атрибутов печати, который определяет носитель, на котором нужно печатать.

ИмяНосителя

Класс MediaName — подкласс Media, класс атрибутов печати (перечисление), которое определяет носитель для задания печати как имя.

ПечатаемаяПлощадьНосителя

Класс MediaPrintableArea используется для различения печатаемых и непечатаемых областей носителя.

РазмерНосителя

Класс MediaSize — это двухмерный класс атрибутов печати, значение которого указывает размеры носителя в портретном формате, где размер X проходит по нижнему краю, а размер Y — по левому краю.

РазмерНосителя.Инженерный

Класс MediaSize.Engineering включает значения MediaSize для инженерных носителей.

РазмерНосителя.ISO

Класс MediaSize.ISO включает значения MediaSize для ISO носителей.

РазмерНосителя.JIS

Класс MediaSize.JIS включает значения MediaSize для JIS (японских) носителей.

РазмерНосителя.NA

Класс MediaSize.NA включает значения MediaSize для североамериканских носителей.

РазмерНосителя.Другие

Класс MediaSize.Other включает значения MediaSize для различных носителей.

ИмяРазмерНосителя

Класс MediaSizeName — это подкласс Media.

ПоддонНосителя

Класс MediaTray — это подкласс Media.

ОбработкаНесколькихДокументов

Класс MultipleDocumentHandling — это класс атрибутов печати, перечисление, которое управляет операциями отделки и размещением одной или нескольких страниц потока печати в отпечатках и на листах носителя.

КоличествоДокументов

Класс NumberOfDocuments — это целочисленный атрибут печати, который указывает количество отдельных документов, принятых принтером для этого задания, независимо от того, достигли ли данные печати принтера или нет.

КоличествоПромежуточныхЗаданий

Класс NumberOfInterveningJobs — это целочисленный атрибут печати, который указывает количество заданий, которые находятся перед этим заданием в относительном хронологическом порядке ожидаемого времени завершения (т. е. текущем запланированном порядке).

РасположениеСтраниц

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

ПоддерживаемоеРасположениеСтраниц

Класс NumberUpSupported — это класс атрибутов печати, набор целых чисел, который предоставляет поддерживаемые значения для атрибута NumberUp.

ЗапрошеннаяОриентация

Класс OrientationRequested — это класс атрибутов печати, перечисление, которое указывает желаемую ориентацию напечатанных страниц потока печати; он не описывает ориентацию предоставленных клиентом страниц потока печати.

OutputDeviceAssigned

Класс OutputDeviceAssigned — это класс атрибутов печати, текстовый атрибут, определяющий устройство вывода, которому служба назначила данную задачу.

PageRanges

Класс PageRanges — это класс атрибутов печати, набор целых чисел, определяющий диапазон(ы) страниц потока печати, которые объект Printer использует для каждого экземпляра каждого документа, подлежащего печати.

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 — это класс атрибутов печати, перечисление, определяющее текущее состояние принтера.

PrinterStateReason

Класс PrinterStateReason — это класс атрибутов печати, перечисление, предоставляющее дополнительную информацию о текущем состоянии принтера, т.е. информацию, дополняющую значение атрибута принтера PrinterState.

PrinterStateReasons

Класс PrinterStateReasons — это класс атрибутов печати, набор значений перечисления, предоставляющий дополнительную информацию о текущем состоянии принтера, т.е. информацию, дополняющую значение атрибута принтера PrinterState.

PrinterURI

Класс PrinterURI — это класс атрибутов печати, URI, определяющий глобально уникальное имя принтера.

PrintQuality

Класс PrintQuality — это класс атрибутов печати, перечисление, определяющее качество печати, используемое принтером для задания.

QueuedJobCount

Класс QueuedJobCount — это целочисленный атрибут печати, указывающий количество заданий в очереди принтера, состояние которых (JobState) равно PENDING, PENDING_HELD, PROCESSING или PROCESSING_STOPPED.

ReferenceUriSchemesSupported

Класс ReferenceUriSchemesSupported — это класс атрибутов печати, перечисление, которое указывает «схему URI», например, «http:» или «ftp:», которую принтер может использовать для получения данных печати, хранящихся в расположении URI.

RequestingUserName

Класс RequestingUserName — это класс атрибутов печати, текстовый атрибут, определяющий имя конечного пользователя, который отправил задание печати.

Severity

Класс Severity — это класс атрибутов печати, перечисление, определяющее уровень серьезности атрибута PrinterStateReason.

SheetCollate

Класс SheetCollate — это класс атрибутов печати, перечисление, определяющее, должны ли листы носителя каждого экземпляра каждого распечатанного документа в задании быть упорядоченными по порядку, когда несколько копий документа задаются атрибутом Copies.

Sides

Класс Sides — это класс атрибутов печати, перечисление, определяющее, как страницы потока печати должны накладываться на стороны экземпляра выбранного носителя, т.е. оттиск.

Описание пакета 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, такое как «processing-stopped» для атрибута JobState. Однако, поскольку класс EnumSyntax расширяем, поставщики могут определить свои собственные значения атрибутов. Если атрибут использует класс EnumSyntax и установлен на одно из этих определённых поставщиком значений, то метод toString не вернёт строковое представление значения IPP.

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

Классы атрибутов в пакете javax.print.attribute.standard основаны на атрибутах протокола печати по Интернету (IPP), как определено в документе RFC Интернета, RFC 2911 Internet Printing Protocol/1.1: Model and Semantics от сентября 2000 года. Для получения дополнительной информации см. RFC 2911. Описательный текст для каждого класса атрибута был в значительной степени взят из вышеупомянутых документов. Вклад авторов вышеупомянутых документов в API признаётся с благодарностью.

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

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

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

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

Атрибуты запроса на печать

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

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

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

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

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

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

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

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

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

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

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

Ниже приведена таблица всех атрибутов печати. Таблица показывает интерфейсы маркировки, которые реализует каждый класс атрибута помимо интерфейса Attribute, таким образом, показывая, как каждый атрибут используется в API. Для каждого атрибута документа и атрибута запроса на печать в столбце «SupportedValuesAttribute» указан класс атрибута поддерживаемых значений, если таковой имеется, с помощью которого служба печати указывает поддерживаемые значения для этой категории атрибутов.
Класс атрибута Атрибут
документа
Атрибут
запроса
печати
Атрибут
задания
печати
Атрибут
службы
печати
АтрибутSupportedValues
Сжатие X
Имя документа X
Цветовой охват X X X
Копии X X Поддерживаемые копии
Оформление X X X
Отложить задание до X X
Отпечатки задания X X Поддерживаемые отпечатки задания
Задание KOctets X X Поддерживаемые JobKOctets
Листы задания Media X X Поддерживаемые листы задания Media
Имя задания X X
Приоритет задания X X Поддерживаемый приоритет задания
Листы задания X X
Носитель X X X
Размер носителя
Обработка нескольких документов X X
Многострочный X X X Поддержка многострочного
Требуемая ориентация X X X
Диапазоны страниц X X X
Направление презентации X X X
Разрешение принтера X X X
Качество печати X X X
Имя пользователя, запросившего действие X X
Сброс листов X X X
Стороны X X X
Дата и время завершения X
Дата и время создания X
Дата и время обработки X
Отпечатки задания, завершенные X
Обработанные JobKOctets задания X
Завершенные листы Media задания X
Сообщение от оператора для задания X
Имя пользователя, создавшего задание X
Состояние задания X
Причины состояния задания
Содержит ноль или более --
X
-- Причина состояния задания
Количество документов X
Количество вмешавшихся заданий X
Назначенное выходное устройство X
Поддержка цвета X
Страниц в минуту X
Страниц в минуту (цвет) X
Поддержка переопределения PDL X
Принтер принимает задания X
Информация о принтере X
Расположение принтера X
Сообщение от оператора принтера X
Производитель и модель принтера X
Дополнительная информация о принтере X
Производитель дополнительной информации о принтере X
Имя принтера X
Состояние принтера X
Причины состояния принтера
Содержит ноль или более --
X
-- Причина состояния принтера
-- Серьезность
Количество заданий в очереди X
Поддерживаемые схемы URI ссылки

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

С:
1.4

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API