javax.print

Интерфейс DocPrintJob

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

CancelablePrintJob, MultiDocPrintJob

public interface DocPrintJob

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

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

Модификатор и Тип	Метод и Описание
void	addPrintJobAttributeListener(PrintJobAttributeListener listener, PrintJobAttributeSet attributes) Регистрирует слушателя для изменений в указанных атрибутах.
void	addPrintJobListener(PrintJobListener listener) Регистрирует слушателя для события, происходящего во время этого задания печати.
PrintJobAttributeSet	getAttributes() Получает этот набор Задания Печати печати атрибутов.
PrintService	getPrintService() Определяет PrintService возразите, с которым связывается этот объект задания печати.
void	print(Doc doc, PrintRequestAttributeSet attributes) Печатает документ с указанными атрибутами задания.
void	removePrintJobAttributeListener(PrintJobAttributeListener listener) Удаляет слушателя атрибута из этого задания печати.
void	removePrintJobListener(PrintJobListener listener) Удаляет слушателя из этого задания печати.

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

getPrintService

PrintService getPrintService()

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

Возвраты:

PrintService объект.

getAttributes

PrintJobAttributeSet getAttributes()

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

Возвраты:

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

addPrintJobListener

void addPrintJobListener(PrintJobListener listener)

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

Параметры:

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

См. Также:

removePrintJobListener(javax.print.event.PrintJobListener)

removePrintJobListener

void removePrintJobListener(PrintJobListener listener)

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

Параметры:

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

См. Также:

addPrintJobListener(javax.print.event.PrintJobListener)

addPrintJobAttributeListener

void addPrintJobAttributeListener(PrintJobAttributeListener listener,
                                  PrintJobAttributeSet attributes)

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

Параметры:

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

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

См. Также:

removePrintJobAttributeListener(javax.print.event.PrintJobAttributeListener)

removePrintJobAttributeListener

void removePrintJobAttributeListener(PrintJobAttributeListener listener)

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

Параметры:

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

См. Также:

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

печать

void print(Doc doc,
           PrintRequestAttributeSet attributes)
    throws PrintException

Печатает документ с указанными атрибутами задания. Однажды этот метод нужно только вызвать для данного задания печати. Вызов этого снова не будет приводить к новому заданию, являющемуся spooled к принтеру. Реализация службы определит политику для прерывания службы и восстановления. Когда метод печати возвращается, печать еще, возможно, не завершилась, поскольку печать может произойти асинхронно, возможно в различном потоке. Клиенты приложения, которые хотят контролировать успех или провал, должны зарегистрировать PrintJobListener.

Конструкторы службы печати должны закрыть любые потоки данных печати (то есть Читатель или реализации InputStream), что они получают из клиентского документа. Устойчивые клиенты могут все еще хотеть проверить это. Исключение всегда сгенерировано если a DocFlavor не может быть напечатан.

Параметры:

doc - Документ, который будет напечатан. Если должна быть разновидность, поддерживаемая этим PrintJob.

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

Броски:

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

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