javax.print

Интерфейсный CancelablePrintJob

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

DocPrintJob

public interface CancelablePrintJob
extends DocPrintJob

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

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

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	cancel() Остановки, далее обрабатывающие задания печати.

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

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

Деталь метода

отмена

void cancel()
            throws PrintException

Остановки, далее обрабатывающие задания печати.

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

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

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

Броски:

PrintException - если задание не могло бы быть успешно отменено.