- java.lang.Object
-
- javafx.print.JobSettings
-
public final class JobSettings extends Object
Класс JobSettings encapsuliрует большую часть конфигурации задания печати. Приложения не могут и не должны напрямую создавать или устанавливать экземпляр JobSettings. Он уже установлен на задании печати при его создании.Как описано в PrinterJob, первоначально установленные параметры JobSettings соответствуют текущим параметрам по умолчанию для принтера, первоначально связанного с заданием.
Делегат JobSettings остается неизменным на протяжении всего срока жизни задания и его свойства обновляются для соответствия изменению принтера задания. Например, в результате взаимодействия пользователя с диалоговым окном платформы. Несовместимые настройки обычно приводят к возврату настроек к значениям по умолчанию для нового принтера.
Любые неявные или явные обновления настроек, полученные в результате взаимодействия пользователя с диалоговым окном, будут переданы приложению после подтверждения пользователем настроек путем закрытия диалогового окна с помощью опции "принять".
Для большинства приложений печати, вероятно, достаточно позволить пользователю задать желаемые параметры и передать их заданию. Для приложений, которым они нужны, существуют методы set и get для отдельных параметров, которые также доступны как свойства, и изменения значений настроек могут контролироваться и обновляться с помощью этих свойств.
Не все значения настроек доступны на всех принтерах. Например, принтер может не поддерживать двустороннюю печать. См. класс
Printerдля получения информации о том, как определить поддерживаемые настройки.- Since:
- JavaFX 8.0
-
Сводка свойств
Свойства Тип Свойство Описание ObjectProperty<Collation>collationСвойство, представляющее экземплярCollation.IntegerPropertycopiesIntegerProperty, представляющее количество копий задания на печать.StringPropertyjobNameStringProperty, представляющее имя задания.ObjectProperty<PageLayout>pageLayoutСвойство, представляющее экземплярPageLayout.ObjectPropertypageRangesObjectProperty, значение которого представляет страницы задания на печать в виде массива PageRange.ObjectProperty<PaperSource>paperSourceСвойство, представляющее экземплярPaperSource.ObjectProperty<PrintColor>printColorСвойство, представляющее экземплярPrintColor.ObjectProperty<PrintQuality>printQualityСвойство, представляющее экземплярPrintQuality.ObjectProperty<PrintResolution>printResolutionСвойство, представляющее экземплярPrintResolution.ObjectProperty<PrintSides>printSidesСвойство, представляющее экземплярPrintSides.
-
Сводка методов
Все методыМетоды экземпляровКонкретные методы Модификатор и тип Метод Описание ObjectProperty<Collation>collationProperty()Свойство, представляющее экземплярCollation.IntegerPropertycopiesProperty()IntegerProperty, представляющее количество копий задания на печать.CollationgetCollation()Сортировка определяет, как листы упорядочиваются при печати нескольких копий документа.intgetCopies()Получить количество копий для печати.StringgetJobName()Получить имя задания.PageLayoutgetPageLayout()Получить текущую компоновку страниц для этого задания.PageRange[]getPageRanges()Диапазон страниц для печати.PaperSourcegetPaperSource()Получить значение свойства paperSource.PrintColorgetPrintColor()Получить значение свойства printColor.PrintQualitygetPrintQuality()Получить значение свойства printQuality.PrintResolutiongetPrintResolution()PrintSidesgetPrintSides()Если принтер это поддерживает, то задание может быть напечатано с обеих сторон носителя (бумаги), т. е. печать на двух сторонах.StringPropertyjobNameProperty()StringProperty, представляющее имя задания.ObjectProperty<PageLayout>pageLayoutProperty()Свойство, представляющее экземплярPageLayout.ObjectPropertypageRangesProperty()ObjectProperty, значение которого представляет страницы задания на печать в виде массива PageRange.ObjectProperty<PaperSource>paperSourceProperty()Свойство, представляющее экземплярPaperSource.ObjectProperty<PrintColor>printColorProperty()Свойство, представляющее экземплярPrintColor.ObjectProperty<PrintQuality>printQualityProperty()Свойство, представляющее экземплярPrintQuality.ObjectProperty<PrintResolution>printResolutionProperty()Свойство, представляющее экземплярPrintResolution.ObjectProperty<PrintSides>printSidesProperty()Свойство, представляющее экземплярPrintSides.voidsetCollation(Collation collation)Установить свойствоCollation.voidsetCopies(int nCopies)Установить количество копий для печати.voidsetJobName(String name)Установить имя задания.voidsetPageLayout(PageLayout pageLayout)Установить используемую компоновку страниц.voidsetPageRanges(PageRange... pages)Диапазон страниц для печати в виде массива PageRange.voidsetPaperSource(PaperSource value)Установить значение свойства paperSource.voidsetPrintColor(PrintColor color)Установить свойствоPrintColor.voidsetPrintQuality(PrintQuality quality)Установить свойствоPrintQuality.voidsetPrintResolution(PrintResolution resolution)Установить свойствоPrintResolution.voidsetPrintSides(PrintSides sides)Установить свойствоPrintSides, которое управляет двухсторонней печатью.StringtoString()
-
Подробности свойства
-
jobName
public final StringProperty jobNameProperty
StringPropertyпредставляющий имя задания.- См. также:
-
getJobName(),setJobName(String)
-
copies
public final IntegerProperty copiesProperty
IntegerPropertyпредставляющий количество копий задания для печати.- См. также:
-
getCopies(),setCopies(int)
-
pageRanges
public final ObjectProperty pageRangesProperty
Массив значений, представляющий страницы задания для печати в виде массива PageRange. Значение null означает печать всех страниц. В противном случае это должен быть массив непересекающихся объектов PageRange, упорядоченных по возрастанию номера страницы. Номера страниц начинаются с 1 (одна). Пустой массив эквивалентен массиву null.Некорректный или неподдерживаемый (принтером) набор диапазонов страниц будет проигнорирован.
Диапазоны, выходящие за пределы числа страниц, отформатированных заданием во время печати, не вызывают никаких ошибок.
- См. также:
-
getPageRanges(),setPageRanges(PageRange[])
-
printSides
public final ObjectProperty<PrintSides> printSidesProperty
Свойство, представляющее экземплярPrintSides.- См. также:
-
getPrintSides(),setPrintSides(PrintSides)
-
collation
public final ObjectProperty<Collation> collationProperty
Свойство, представляющее экземплярCollation.- См. также:
-
getCollation(),setCollation(Collation)
-
printColor
public final ObjectProperty<PrintColor> printColorProperty
Свойство, представляющее экземплярPrintColor.- См. также:
-
getPrintColor(),setPrintColor(PrintColor)
-
printQuality
public final ObjectProperty<PrintQuality> printQualityProperty
Свойство, представляющее экземплярPrintQuality.- См. также:
-
getPrintQuality(),setPrintQuality(PrintQuality)
-
printResolution
public final ObjectProperty<PrintResolution> printResolutionProperty
Свойство, представляющее экземплярPrintResolution.
-
paperSource
public final ObjectProperty<PaperSource> paperSourceProperty
Свойство, представляющее экземплярPaperSource.- См. также:
-
getPaperSource(),setPaperSource(PaperSource)
-
pageLayout
public final ObjectProperty<PageLayout> pageLayoutProperty
Свойство, представляющее экземплярPageLayout.- См. также:
-
getPageLayout(),setPageLayout(PageLayout)
-
-
Метод Detail
-
jobNameProperty
public final StringProperty jobNameProperty()
StringPropertyпредставляющий имя задания.- См. также:
-
getJobName(),setJobName(String)
-
getJobName
public String getJobName()
Получить имя задания.- Возвращает:
- строка, представляющая имя задания
-
setJobName
public void setJobName(String name)
Установить имя задания.- Параметры:
-
name- строка, представляющая имя задания
-
copiesProperty
public final IntegerProperty copiesProperty()
IntegerPropertyпредставляющий количество копий задания для печати.- См. также:
-
getCopies(),setCopies(int)
-
getCopies
public int getCopies()
Получить количество копий для печати.- Возвращает:
- количество копий для печати
-
setCopies
public final void setCopies(int nCopies)
Установить количество копий для печати.- Параметры:
-
nCopies- количество копий для печати
-
pageRangesProperty
public final ObjectProperty pageRangesProperty()
МассивObjectProperty, значение которого представляет страницы задания для печати в виде массива PageRange. Значение null означает печать всех страниц. В противном случае это должен быть массив непересекающихся объектов PageRange, упорядоченных по возрастанию номера страницы. Номера страниц начинаются с 1 (одного). Пустой массив эквивалентен массиву null.Незаконный или неподдерживаемый (принтером) набор диапазонов страниц будет проигнорирован.
Диапазоны, превышающие количество страниц, отформатированных заданием во время печати, не вызывают никаких ошибок.
- См. также:
-
getPageRanges(),setPageRanges(PageRange[])
-
getPageRanges
public PageRange[] getPageRanges()
Диапазон страниц для печати. null всегда означает все страницы. Подробнее см.pageRangesProperty().- Возвращает:
- null или массив, как указано выше
-
setPageRanges
public void setPageRanges(PageRange... pages)
Диапазон страниц для печати в виде массива PageRange. Использование varargs означает, что общий случай одного диапазона может быть неявно преобразован.((PageRange[])null)всегда означает все страницы, однако, поскольку это значение по умолчанию, оно используется реже. Подробнее см.pageRangesProperty().- Параметры:
-
pages- null или массив varargs, как указано выше
-
printSidesProperty
public final ObjectProperty<PrintSides> printSidesProperty()
Свойство, представляющее экземплярPrintSides.- См. также:
-
getPrintSides(),setPrintSides(PrintSides)
-
getPrintSides
public PrintSides getPrintSides()
Если принтер поддерживает, задание может быть распечатано с обеих сторон носителя (бумаги), то есть с дуплексной печатью. Этот метод возвращает выбранное значение.- Возвращает:
- настройки дуплексной печати (стороны).
-
setPrintSides
public void setPrintSides(PrintSides sides)
Установить свойствоPrintSides, которое управляет дуплексной печатью. Значение null игнорируется.- Параметры:
-
sides- новые настройки количества сторон.
-
collationProperty
public final ObjectProperty<Collation> collationProperty()
Свойство, представляющее экземплярCollation.- См. также:
-
getCollation(),setCollation(Collation)
-
getCollation
public Collation getCollation()
Сортировка определяет, как листы сортируются при печати нескольких копий документа. Таким образом, это актуально только при печати 2 или более копий документа с 2 или более листами. Лист — это физический носитель, поэтому документы с 2 страницами, напечатанные в N-экземплярах или с двух сторон, могут по-прежнему иметь только один лист. Задание с сортировкой печатает документы с листами документа в последовательности. Несортированное задание собирает вместе несколько копий одного листа. Несортированный (false) — типичное значение по умолчанию.- Возвращает:
- сортировку
-
setCollation
public void setCollation(Collation collation)
Установить свойствоCollation. Значение null игнорируется.- Параметры:
-
collation- новые настройки сортировки
-
printColorProperty
public final ObjectProperty<PrintColor> printColorProperty()
Свойство, представляющее экземплярPrintColor.- См. также:
-
getPrintColor(),setPrintColor(PrintColor)
-
getPrintColor
public PrintColor getPrintColor()
Получает значение свойства printColor.- Описание свойства:
- Свойство, представляющее экземпляр
PrintColor.
-
setPrintColor
public void setPrintColor(PrintColor color)
Установить свойствоPrintColor. Значение null игнорируется.- Параметры:
-
color- новые настройки цвета печати.
-
printQualityProperty
public final ObjectProperty<PrintQuality> printQualityProperty()
Свойство, представляющее экземплярPrintQuality.- См. также:
-
getPrintQuality(),setPrintQuality(PrintQuality)
-
getPrintQuality
public PrintQuality getPrintQuality()
Получает значение свойства printQuality.- Описание свойства:
- Свойство, представляющее экземпляр
PrintQuality.
-
setPrintQuality
public void setPrintQuality(PrintQuality quality)
Установить свойствоPrintQuality. Значение null игнорируется.Обратите внимание, что качество и разрешение — перекрывающиеся понятия. Поэтому принтер может поддерживать настройку одного или другого, но не обоих. Приложения, настраивающие эти параметры программно, должны запросить оба свойства и выбрать подходящие значения из поддерживаемых. Если принтер поддерживает нестандартные значения, код, вероятно, не сможет различить интерпретацию этих значений принтером, и безопаснее всего придерживаться выбора стандартного значения, соответствующего требованию.
- Параметры:
-
quality- новые настройки качества печати.
-
printResolutionProperty
public final ObjectProperty<PrintResolution> printResolutionProperty()
Свойство, представляющее экземплярPrintResolution.
-
getPrintResolution
public PrintResolution getPrintResolution()
- Возвращает:
- разрешение печати
-
setPrintResolution
public void setPrintResolution(PrintResolution resolution)
Установить свойствоPrintResolution. Значение null игнорируется.Обратите внимание, что качество и разрешение — перекрывающиеся понятия. Поэтому принтер может поддерживать настройку одного или другого, но не обоих. Приложения, настраивающие эти параметры программно, должны запросить оба свойства и выбрать подходящие значения из поддерживаемых. Если принтер поддерживает нестандартные значения, код, вероятно, не сможет различить интерпретацию этих значений принтером, и безопаснее всего придерживаться выбора стандартного значения, соответствующего требованию.
- Параметры:
-
resolution- новые настройки разрешения печати.
-
paperSourceProperty
public final ObjectProperty<PaperSource> paperSourceProperty()
Свойство, представляющее экземплярPaperSource.- См. также:
-
getPaperSource(),setPaperSource(PaperSource)
-
getPaperSource
public PaperSource getPaperSource()
Получает значение свойства paperSource.- Описание свойства:
- Свойство, представляющее экземпляр
PaperSource.
-
setPaperSource
public void setPaperSource(PaperSource value)
Устанавливает значение свойства paperSource.- Описание свойства:
- Свойство, представляющее экземпляр
PaperSource.
-
-
pageLayoutProperty
public final ObjectProperty<PageLayout> pageLayoutProperty()
Свойство, представляющее экземплярPageLayout.- См. также:
-
getPageLayout(),setPageLayout(PageLayout)
-
getPageLayout
public PageLayout getPageLayout()
Получить текущую макет страниц для данной задачи.- Возвращает:
- макет страниц для использования в задаче.
-
setPageLayout
public void setPageLayout(PageLayout pageLayout)
Установить макет страницы для использования.- Параметры:
-
pageLayout- Используемый макет страницы.
-
© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.