Интерфейс PrintJobListener

Все известные реализующие классы:: PrintJobAdapter

public interface PrintJobListener

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

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`printDataTransferCompleted(PrintJobEvent pje)`	Вызывается, чтобы уведомить клиента об успешной передаче данных службе печати и о том, что клиент может освободить локальные ресурсы, выделенные для этих данных.
`void`	`printJobCanceled(PrintJobEvent pje)`	Вызывается, чтобы уведомить клиента об отмене задания пользователем или программой.
`void`	`printJobCompleted(PrintJobEvent pje)`	Вызывается, чтобы уведомить клиента об успешном завершении задания.
`void`	`printJobFailed(PrintJobEvent pje)`	Вызывается, чтобы уведомить клиента о том, что задание не удалось успешно завершить и его потребуется отправить повторно.
`void`	`printJobNoMoreEvents(PrintJobEvent pje)`	Вызывается, чтобы уведомить клиента о том, что больше события доставляться не будут.
`void`	`printJobRequiresAttention(PrintJobEvent pje)`	Вызывается, чтобы уведомить клиента об ошибке, которую пользователь, возможно, сможет исправить.

Подробное описание методов

printDataTransferCompleted

void printDataTransferCompleted(PrintJobEvent pje)

Вызывается, чтобы уведомить клиента об успешной передаче данных службе печати и о том, что клиент может освободить локальные ресурсы, выделенные для этих данных. После получения этого события клиенту не следует считать, что данные полностью напечатаны. Если это событие не получено, клиенту следует дождаться завершающего события (completed/canceled/failed), прежде чем освобождать ресурсы.

Параметры:: pje — задание, сгенерировавшее это событие

printJobCompleted

void printJobCompleted(PrintJobEvent pje)

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

Параметры:: pje — задание, сгенерировавшее это событие

printJobFailed

void printJobFailed(PrintJobEvent pje)

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

Параметры:: pje — задание, сгенерировавшее это событие

printJobCanceled

void printJobCanceled(PrintJobEvent pje)

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

Параметры:: pje — задание, сгенерировавшее это событие

printJobNoMoreEvents

void printJobNoMoreEvents(PrintJobEvent pje)

Вызывается, чтобы уведомить клиента о том, что больше события доставляться не будут. Это событие может быть сгенерировано, например, если задание успешно завершено, но возможности системы печати ограничены и она не может это подтвердить. Это событие должно быть доставлено, если не доставлено ни одно из других завершающих событий (completed/failed/canceled).

Параметры:: pje — задание, сгенерировавшее это событие

printJobRequiresAttention

void printJobRequiresAttention(PrintJobEvent pje)

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

Параметры:: pje — задание, сгенерировавшее это событие

© 1993, 2025, 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/print/event/PrintJobListener.html