Интерфейс 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)

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

Параметры:: pje - задача, генерирующая это событие

printJobCompleted

void printJobCompleted(PrintJobEvent pje)

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

Параметры:: pje - задача, генерирующая это событие

printJobFailed

void printJobFailed(PrintJobEvent pje)

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

Параметры:: pje - задача, генерирующая это событие

printJobCanceled

void printJobCanceled(PrintJobEvent pje)

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

Параметры:: pje - задача, генерирующая это событие

printJobNoMoreEvents

void printJobNoMoreEvents(PrintJobEvent pje)

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

Параметры:: 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/print/event/PrintJobListener.html