Интерфейс 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, если отмена не удалась. Задание, которое ещё не было отправлено на печать, должно выбросить это исключение. Отмена уже успешно отменённого задания печати не считается ошибкой и всегда будет успешной.

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

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

© 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/CancelablePrintJob.html