Интерфейс PrintJobListener
- Все известные реализующие классы:
PrintJobAdapter
public interface PrintJobListener
Реализации этого интерфейса слушателя должны быть присоединены к
DocPrintJob, чтобы отслеживать состояние задания печати. Эти методы обратного вызова могут быть вызваны в потоке, обрабатывающем задание печати, или в потоке уведомлений, созданном службой. В любом случае клиент не должен выполнять длительную обработку в этих методах обратного вызова.Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
printDataTransferCompleted |
Вызывается для уведомления клиента о том, что данные успешно переданы в службу печати, и клиент может освободить локальные ресурсы, выделенные для этих данных. |
void |
printJobCanceled |
Вызывается для уведомления клиента о том, что задание было отменено пользователем или программой. |
void |
printJobCompleted |
Вызывается для уведомления клиента о том, что задание завершилось успешно. |
void |
printJobFailed |
Вызывается для уведомления клиента о том, что задание не удалось завершить успешно и его необходимо будет переотправить. |
void |
printJobNoMoreEvents |
Вызывается для уведомления клиента о том, что больше событий не будет передано. |
void |
printJobRequiresAttention |
Вызывается для уведомления клиента о том, что произошла ошибка, которую пользователь, возможно, сможет исправить. |
Подробное описание методов
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, 2023, 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/21/docs/api/java.desktop/javax/print/event/PrintJobListener.html