Интерфейс DocPrintJob

public interface DocPrintJob

Методы

getPrintService

PrintService getPrintService()

Определяет объект PrintService, к которому привязана эта задача печати.

Возвращает:

PrintService объект.

getAttributes

PrintJobAttributeSet getAttributes()

Получает набор атрибутов печати для данной задачи печати. Возвращаемый объект набора атрибутов неизменяем. Возвращаемый объект набора атрибутов представляет собой "мгновенный снимок" набора атрибутов этой задачи печати на момент вызова метода getAttributes(); то есть содержимое возвращаемого набора атрибутов не будет обновляться, если содержимое набора атрибутов данной задачи печати изменится в будущем. Для обнаружения изменений значений атрибутов вызовите getAttributes() снова и сравните новый набор атрибутов с предыдущим; или зарегистрируйте слушателя для событий задачи печати. Возвращаемое значение может быть пустым набором, но не должно быть нулевым.

Возвращает:

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

addPrintJobListener

void addPrintJobListener(PrintJobListener listener)

Регистрирует слушателя для событий, происходящих во время выполнения этой задачи печати. Если listener равен null, исключение не генерируется и никаких действий не выполняется. Если listener уже зарегистрирован, он будет зарегистрирован снова.

Параметры:

listener - Объект, реализующий интерфейс слушателя

См. также:

removePrintJobListener(javax.print.event.PrintJobListener)

removePrintJobListener

void removePrintJobListener(PrintJobListener listener)

Удаляет слушателя из этой задачи печати. Этот метод не выполняет никаких функций и не генерирует исключение, если слушатель, указанный в аргументе, ранее не был добавлен к этому компоненту. Если listener равен null, исключение не генерируется и никаких действий не выполняется. Если слушатель был зарегистрирован более одного раза, будет удалена только одна из регистраций.

Параметры:

listener - Объект, реализующий интерфейс слушателя

См. также:

addPrintJobListener(javax.print.event.PrintJobListener)

addPrintJobAttributeListener

void addPrintJobAttributeListener(PrintJobAttributeListener listener,
                                  PrintJobAttributeSet attributes)

Регистрирует слушателя для изменений в указанных атрибутах. Если listener равен null, исключение не генерируется и никаких действий не выполняется. Чтобы определить обновления атрибутов, которые могут быть сообщены данной задачей, клиент может вызвать getAttributes() и определить подмножество, которое является интересным и, вероятно, будет сообщено слушателю. Клиенты, ожидающие обновлений о изменениях конкретного атрибута задания, должны проверить, включён ли он в этот набор, но обновления об атрибуте будут выполнены только в случае изменения и обнаружения этого изменения задачей. Кроме того, обновления могут быть подвержены объединению задачей. Чтобы минимизировать издержки при обработке задач печати, рекомендуется прослушивать только подмножество атрибутов, которые, вероятно, изменятся. Если указанный набор пустой, обновления атрибутов не будут сообщены слушателю. Если набор атрибутов равен null, это означает прослушивание всех динамических атрибутов, поддерживаемых задачей. Это может привести к отсутствию уведомлений об обновлениях, если задача не может сообщить о каких-либо обновлениях атрибутов. Если listener уже зарегистрирован, он будет зарегистрирован снова.

Параметры:

listener - Объект, реализующий интерфейс слушателя

attributes - Атрибуты для прослушивания, или null, чтобы означать все атрибуты, которые могут меняться, как определено задачей.

См. также:

removePrintJobAttributeListener(javax.print.event.PrintJobAttributeListener)

removePrintJobAttributeListener

void removePrintJobAttributeListener(PrintJobAttributeListener listener)

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

Параметры:

listener - Объект, реализующий интерфейс слушателя

См. также:

addPrintJobAttributeListener(javax.print.event.PrintJobAttributeListener, javax.print.attribute.PrintJobAttributeSet)

print

void print(Doc doc,
           PrintRequestAttributeSet attributes)
    throws PrintException

Параметры:

doc - Печатаемый документ. Он должен быть совместим с этой задачей печати.

attributes - Атрибуты задания, применяемые к этой задаче печати. Если этот параметр равен null, используются стандартные атрибуты.

Исключения:

PrintException - Исключение дополнительно может реализовывать интерфейс, который более точно описывает причину исключения

• FlavorException. Если у документа есть формат, не поддерживаемый данной задачей печати.
• AttributeException. Если один или несколько атрибутов не действительны для данной задачи печати.