Spec-Zone .ru
спецификации, руководства, описания, API
|
public final class PrinterJob extends java.lang.Object
Это включает
Здесь ia очень простой пример, который печатает единственный узел.
Node node = new Circle(100, 200, 200); PrinterJob job = PrinterJob.createPrinterJob(); if (job != null) { boolean success = job.printPage(node); if (success) { job.endJob(); } }Моменты, которые необходимо отметить,
В примере выше узла не был добавлен к сцене. Так как большинство сценариев печати печатает контент, это или не выводится на экран вообще, или должно быть подготовлено и отформатировано по-другому, это является совершенно приемлемым.
Если контент, который является в настоящий момент частью Сцены и выводится на экран, печатается, то, потому что, печатая задание или даже единственная страница задания может охватить по многократному экрану "импульсы" или фреймы, для приложения важно гарантировать, что напечатанный узел не обновляется во время процесса печати, еще частичного, или намазал рендеринг, вероятно.
Должно быть очевидно, что то же самое применяется даже к узлам, которые не выводятся на экран - обновление их параллельный с печатью их не является хорошей идеей.
Нет никакого требования, чтобы сделать печать на потоке приложения FX. Узел может быть подготовлен к тому, что он напечатал на любом потоке, задание может быть вызвано на любой поток. Однако, уменьшение объема работы, сделанного на потоке приложения FX, является обычно требуемым, чтобы не влиять на скорость отклика приложения UI. Таким образом, рекомендация состоит в том, чтобы выполнить печать на новом потоке и позволить реализации внутренне планировать любые задачи, которые должны быть выполнены на потоке FX, который будет работаться тот поток.
Ввести | Свойство и Описание |
---|---|
ReadOnlyObjectProperty<PrinterJob.JobStatus> |
jobStatus
Объектное свойство только для чтения, представляющее ток
JobStatus |
ObjectProperty<Printer> |
принтер
Свойство, представляющее
Printer для этого задания. |
Модификатор и Тип | Класс и Описание |
---|---|
static class |
PrinterJob. JobStatus
Перечислимый class используется в создании отчетов о состоянии задания печати.
|
Модификатор и Тип | Метод и Описание |
---|---|
void |
cancelJob()
Отмените базовое задание печати при первой возможности.
|
static PrinterJob |
createPrinterJob()
Метод фабрики, чтобы создать задание.
|
static PrinterJob |
createPrinterJob(Printer printer)
Метод фабрики, чтобы создать задание для указанного принтера.
|
boolean |
endJob()
Если задание может быть успешно spooled очереди принтера, это возвратит true.
|
JobSettings |
getJobSettings()
JobSettings инкапсулирует весь API поддерживаемые параметры конфигурации задания, такие как число копий, опции сопоставления, дуплексной опции, и т.д. |
PrinterJob. JobStatus |
getJobStatus()
Получите текущий статус задания.
|
Принтер |
getPrinter()
Связали принтер в настоящий момент с этим заданием.
|
ReadOnlyObjectProperty<PrinterJob.JobStatus> |
jobStatusProperty()
Объектное свойство только для чтения, представляющее ток
JobStatus |
ObjectProperty<Printer> |
printerProperty()
Свойство, представляющее
Printer для этого задания. |
boolean |
printPage(Node node)
Напечатайте указанный узел.
|
boolean |
printPage(PageLayout pageLayout, Node node)
Напечатайте указанный узел, используя указанный макет страницы.
|
void |
setPrinter(Printer printer)
Измените принтер для этого задания.
|
boolean |
showPageSetupDialog(Window owner)
Выводит на экран диалоговое окно Установки Страницы.
|
boolean |
showPrintDialog(Window owner)
Выводит на экран Диалоговое окно Печати.
|
java.lang.String |
toString() |
public final ObjectProperty<Принтер> printerProperty
Printer
для этого задания.getPrinter()
, setPrinter(Printer)
public ReadOnlyObjectProperty<PrinterJob. JobStatus> jobStatusProperty
JobStatus
getJobStatus()
public static final PrinterJob createPrinterJob()
java.lang.SecurityException
- если у задания нет разрешения, чтобы инициировать задание принтера.public static final PrinterJob createPrinterJob(Printer printer)
printer
параметр определяет начальный принтер
printer
- использовать для задания. Если принтер в настоящий момент недоступен (eg офлайн) тогда, это может возвратить нуль.java.lang.SecurityException
- если у задания нет разрешения, чтобы инициировать задание принтера.public final ObjectProperty<Принтер> printerProperty()
Printer
для этого задания.getPrinter()
, setPrinter(Printer)
public Принтер getPrinter()
public void setPrinter(Printer printer)
Вышеупомянутое применяется, изменяется ли принтер, непосредственно вызывая этот метод, или как побочный эффект взаимодействия с пользователем с диалоговым окном печати.
Устанавливание нулевого принтера или текущего принтера игнорируется.
printer
- использоваться для этого задания печати.public JobSettings getJobSettings()
JobSettings
инкапсулирует весь API поддерживаемые параметры конфигурации задания, такие как число копий, опции сопоставления, дуплексной опции, и т.д. Начальные значения основаны на текущих настройках для начального принтера.public boolean showPrintDialog(Window owner)
В случае, что нет никакого UI, доступного тогда, этот метод возвращает true без измененных опций, как будто пользователь подтвердил, чтобы продолжиться с печатью.
Если задание не будет в состоянии, чтобы вывести на экран диалоговое окно, такое как уже печать, отмененная или сделанная, то диалоговое окно не будет выведено на экран, и метод возвратит false.
Окно owner
может быть нуль, но если это будет видимое Окно, то это будет использоваться в качестве родителя.
owner
- к которому можно блокировать ввод, или нуль.public boolean showPageSetupDialog(Window owner)
Это выведет на экран самое соответствующее доступное диалоговое окно с этой целью. Однако может быть все еще быть доступом к другим настройкам, включая изменение текущего принтера. Поэтому побочный эффект этого диалогового метода дисплея может состоять в том, чтобы обновить это и любые другие текущие настройки задания. Метод возвращает true, если пользователь, подтвержденный диалоговое окно, производятся ли любые изменения.
Если задание не будет в состоянии, чтобы вывести на экран диалоговое окно, такое как уже печать, отмененная или сделанная, то диалоговое окно не будет выведено на экран, и метод возвратит false.
Окно owner
может быть нуль, но если это будет видимое Окно, то это будет использоваться в качестве родителя.
owner
- блокировать ввод, или нуль.public boolean printPage(PageLayout pageLayout, Node node)
pageLayout
- Расположение для этой страницы.node
- Узел, чтобы напечатать.java.lang.NullPointerException
- если любой параметр является нулем.public boolean printPage(Node node)
node
- Узел, чтобы напечатать.java.lang.NullPointerException
- если параметр узла является нулем.public ReadOnlyObjectProperty<PrinterJob. JobStatus> jobStatusProperty()
JobStatus
getJobStatus()
public PrinterJob. JobStatus getJobStatus()
JobStatus
public void cancelJob()
Вызов не имеет никакого эффекта, если задание уже требовали быть ОТМЕНЕННЫМ, или находится по ОШИБКЕ состояния или СДЕЛАНО. Например это не будет исключать из очереди от принтера задание, которое уже было spooled для того, чтобы напечатать. Как только задание отменяется, это не допустимо, чтобы вызвать любые методы, которые представляют новый контент или состояние задания изменения.
public boolean endJob()
Возвращаемое значение лжи означает, что задание не могло быть spooled, или было уже завершено.
Успешное завершение также обновит состояние задания к DONE
, в которой точке больше не может использоваться задание.
Вызов endJob () на задании, для которого не были напечатаны никакие страницы, эквивалентен вызову {кодируют cancelJob ()}.
public java.lang.String toString()
toString
в class java.lang.Object
Copyright (c) 2008, 2013, Oracle и/или его филиалы. Все права защищены. Использование подвергается