Spec-Zone .ru
спецификации, руководства, описания, API
|
public interface CancelablePrintJob extends DocPrintJob
DocPrintJob
. A DocPrintJob
реализация, возвращенная из службы печати, реализует этот интерфейс, если задание печати может быть отменено. Прежде, чем попытаться отменить задание печати, клиент должен протестировать если DocPrintJob
объект, возвращенный из службы печати фактически, реализует этот интерфейс. Клиенты никогда не должны принимать это a DocPrintJob
реализации этот интерфейс. Служба печати могла бы поддерживать отмену только для определенных типов данных печати и представления имена class. Это означает что только часть из DocPrintJob
объекты, возвращенные из службы, реализуют этот интерфейс. Конструкторы службы поощряются реализовать этот дополнительный интерфейс и поставить событие javax.print.event.PrintJobEvent.JOB_CANCELLED любым слушателям, если задание успешно отменяется с реализацией этого интерфейса. Службы должны также отметить, что реализация этого метода может быть сделана из отдельного клиентского потока чем то, что обращалось с просьбой печати. Таким образом реализация этого интерфейса должна быть сделана ориентированной на многопотоковое исполнение.
Модификатор и Тип | Метод и Описание |
---|---|
void |
cancel()
Остановки, далее обрабатывающие задания печати.
|
addPrintJobAttributeListener, addPrintJobListener, getAttributes, getPrintService, print, removePrintJobAttributeListener, removePrintJobListener
void cancel() throws PrintException
Если служба поддерживает этот метод, нельзя прийти к заключению, что отмена задания всегда будет suceeed. Задание, возможно, не в состоянии быть отмененным, как только оно достигло и передало некоторую точку в своей обработке. Успешная отмена означает только, что все задание не было напечатано, некоторая часть, возможно, уже напечатала, когда отмена возвращается.
Служба бросит PrintException, если отмена не успешно выполнялась. Задание, которое еще не было представлено для того, чтобы напечатать, должно выдать это исключение. Отмену уже успешно отмененного Задания Печати не считают ошибкой и будет всегда успешно выполняться.
Отмена в некоторых службах может быть долгим процессом, включая запросы к серверу и обрабатывая его очереди печати. Клиенты могут хотеть выполнить отмену в потоке, который не влияет на выполнение приложения.
PrintException
- если задание не могло бы быть успешно отменено.
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92