Класс JobSettings

public final StringProperty jobNameProperty

StringProperty представляющее имя задания.

public final StringProperty outputFileProperty

A StringProperty, представляющее имя файла файловой системы, в который драйвер платформенного принтера должен поместить отформатированные данные печати.

Приложения могут использовать это для программирования поведения печати в файл, когда собственная система печати способна сохранять вывод в файл файловой системы, а не в устройство принтера.

Это часто полезно, когда драйвер принтера генерирует формат, такой как Postscript или PDF, и приложение намеревается распространить результат, а не печатать его, или по какой-либо другой причине приложение не хочет, чтобы физические носители (бумага) выпускались принтером.

Значение по умолчанию — пустая строка, которая интерпретируется как не заданное, эквивалентное null, что означает, что вывод отправляется на принтер. Таким образом, чтобы вернуть печать на принтер, очистите значение этого свойства, установив его в null или пустую строку.

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

Если система печати не поддерживает печать в файл, то это значение будет проигнорировано.

Если указанное имя задаёт несуществующий путь или не задаёт файл, доступный для записи пользователем, при печати результаты зависят от платформы. Возможные действия могут включать замену на стандартное местоположение выходного файла, печать на принтере вместо этого или ошибку платформы печати. Если установлен SecurityManager и он отказывает в доступе к указанному файлу, может быть выброшено исключение SecurityException.

public final IntegerProperty copiesProperty

IntegerProperty представляющее количество копий задания для печати.

public final ObjectProperty pageRangesProperty

An ObjectProperty, значение которого представляет страницы задания для печати в виде массива PageRange. Значение null означает печать всех страниц. В противном случае это должен быть массив неперекрывающихся объектов PageRange, отсортированных по возрастанию номера страницы. Номера страниц начинаются с 1. Пустой массив считается эквивалентным массиву null.

Неправильный или неподдерживаемый (принтером) набор диапазонов страниц будет проигнорирован.

Диапазоны, выходящие за пределы количества страниц, отображаемых заданием во время печати, не вызывают ошибок.

public final ObjectProperty<PrintSides> printSidesProperty

Свойство, представляющее экземпляр PrintSides.

public final ObjectProperty<Collation> collationProperty

Свойство, представляющее экземпляр Collation.

public final ObjectProperty<PrintColor> printColorProperty

Свойство, представляющее экземпляр PrintColor.

public final ObjectProperty<PrintQuality> printQualityProperty

Свойство, представляющее экземпляр PrintQuality.

public final ObjectProperty<PrintResolution> printResolutionProperty

Свойство, представляющее экземпляр PrintResolution.

public final ObjectProperty<PaperSource> paperSourceProperty

Свойство, представляющее экземпляр PaperSource.

public final ObjectProperty<PageLayout> pageLayoutProperty

Свойство, представляющее экземпляр PageLayout.

public final StringProperty jobNameProperty()

StringProperty представляющее имя задания.

public String getJobName()

Получить имя задания.

public void setJobName(String name)

Установить имя задания.

public final StringProperty outputFileProperty()

A StringProperty representing the name of a filesystem file, to which the platform printer driver should spool the rendered print data.

Applications can use this to programmatically request print-to-file behavior where the native print system is capable of spooling the output to a filesystem file, rather than the printer device.

This is often useful where the printer driver generates a format such as Postscript or PDF, and the application intends to distribute the result instead of printing it, or for some other reason the application does not want physical media (paper) emitted by the printer.

The default value is an empty string, which is interpreted as unset, equivalent to null, which means output is sent to the printer. So in order to reset to print to the printer, clear the value of this property by setting it to null or an empty string.

Additionally if the application displays a printer dialog which allows the user to specify a file destination, including altering an application specified file destination, the value of this property will reflect that user-specified choice, including clearing it to reset to print to the printer, if the user does so.

If the print system does not support print-to-file, then this setting will be ignored.

If the specified name specifies a non-existent path, or does not specify a user writable file, when printing the results are platform-dependent. Possible behaviours might include replacement with a default output file location, printing to the printer instead, or a platform printing error. If a SecurityManager is installed and it denies access to the specified file a SecurityException may be thrown.

public String getOutputFile()

Получить значение свойства outputFile.

public void setOutputFile(String filePath)

Устанавливает значение свойства outputFile.

public final IntegerProperty copiesProperty()

IntegerProperty представляющее количество копий задания для печати.

public int getCopies()

Получение количества копий для печати.

public final void setCopies(int nCopies)

Установление количества копий для печати.

public final ObjectProperty pageRangesProperty()

ObjectProperty, значение которого представляет страницы задания для печати в виде массива PageRange. Значение null означает печать всех страниц. В противном случае это должен быть массив неперекрывающихся объектов PageRange, отсортированных по возрастанию номера страницы. Номера страниц начинаются с 1 (один). Пустой массив считается эквивалентным null-массиву.

Некорректный или неподдерживаемый (принтером) набор диапазонов страниц будет проигнорирован.

Диапазоны, выходящие за пределы количества страниц, отрендеренных заданием во время печати, не вызывают ошибок.

public PageRange[] getPageRanges()

Диапазон страниц для печати. null всегда означает все страницы. См. pageRangesProperty() для получения дополнительной информации.

public void setPageRanges(PageRange... pages)

Диапазон страниц для печати в виде массива PageRange. Использование varargs означает, что в общем случае одиночный диапазон может быть автоматически упакован. ((PageRange[])null) всегда означает все страницы, однако, поскольку это значение по умолчанию, оно используется реже. См. pageRangesProperty() для получения дополнительной информации.

public final ObjectProperty<PrintSides> printSidesProperty()

Свойство, представляющее экземпляр PrintSides.

public PrintSides getPrintSides()

Если принтер его поддерживает, задание может быть напечатано на обеих сторонах носителя (бумаги), то есть с двух сторон. Этот метод возвращает выбранное значение.

public void setPrintSides(PrintSides sides)

Установить свойство PrintSides, которое управляет двусторонней печатью. Значение null игнорируется.

public final ObjectProperty<Collation> collationProperty()

Свойство, представляющее экземпляр Collation.

public Collation getCollation()

Сортировка определяет, как листы сортируются при печати нескольких копий документа. Поэтому она актуальна только при печати 2 или более копий документа с 2 или более листами. Лист — это физический носитель, поэтому документы с 2 страницами, напечатанные N-страничными или двухсторонними, могут по-прежнему содержать только один лист. Задание сортированной печати создает документы, у которых листы документа отсортированы последовательно. Несортированное задание собирает вместе несколько копий одного и того же листа. Несортированная печать (false) — это типовое значение по умолчанию.

public void setCollation(Collation collation)

Установить свойство Collation. Значение null игнорируется.

public final ObjectProperty<PrintColor> printColorProperty()

Свойство, представляющее экземпляр PrintColor.

public PrintColor getPrintColor()

Получение значения свойства printColor.

public void setPrintColor(PrintColor color)

Установить свойство PrintColor. Значение null игнорируется.

public final ObjectProperty<PrintQuality> printQualityProperty()

Свойство, представляющее экземпляр PrintQuality.

public PrintQuality getPrintQuality()

Получение значения свойства printQuality.

public void setPrintQuality(PrintQuality quality)

Установить свойство PrintQuality. Значение null игнорируется.

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

public final ObjectProperty<PrintResolution> printResolutionProperty()

Свойство, представляющее экземпляр PrintResolution.

public void setPrintResolution(PrintResolution resolution)

Установить свойство PrintResolution. Значение null игнорируется.

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

public final ObjectProperty<PaperSource> paperSourceProperty()

Свойство, представляющее экземпляр PaperSource.

public PaperSource getPaperSource()

Возвращает значение свойства paperSource.

public void setPaperSource(PaperSource value)

Устанавливает значение свойства paperSource.

public final ObjectProperty<PageLayout> pageLayoutProperty()

Свойство, представляющее экземпляр PageLayout.

public PageLayout getPageLayout()

Получает текущий макет страницы для этой работы.

public void setPageLayout(PageLayout pageLayout)

Устанавливает макет страницы для использования.