Интерфейс CancelablePrintJob

Все суперинтерфейсы:: DocPrintJob

public interface CancelablePrintJob extends DocPrintJob

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

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

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

Модификатор и тип	Метод	Описание
`void`	`cancel()`	Останавливает дальнейшую обработку задания печати.

Методы, объявленные в интерфейсе javax.print.DocPrintJob

addPrintJobAttributeListener, addPrintJobListener, getAttributes, getPrintService, print, removePrintJobAttributeListener, removePrintJobListener

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

cancel

void cancel() throws PrintException

Останавливает дальнейшую обработку задания печати.

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

Служба выбросит PrintException , если отмена не удалась. Задание, которое ещё не было отправлено на печать, должно выбросить это исключение. Отмена уже успешно отменённого задания печати не считается ошибкой и всегда будет успешной.

Отмена в некоторых службах может быть длительным процессом, включающим запросы к серверу и обработку очереди печати. Клиенты могут захотеть выполнить cancel в нити, которая не влияет на выполнение приложения.

Выбрасывает:: PrintException - если задание не удалось успешно отменить

© 1993, 2021, 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/17/docs/api/java.desktop/javax/print/CancelablePrintJob.html