Spec-Zone.ru › OpenJavaFX 11
Модуль javafx.graphics
Пакет javafx.print

Класс JobSettings

  • 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.
    IntegerProperty copies
    IntegerProperty, представляющее количество копий задания на печать.
    StringProperty jobName
    StringProperty, представляющее имя задания.
    ObjectProperty<PageLayout> pageLayout
    Свойство, представляющее экземпляр PageLayout.
    ObjectProperty pageRanges
    ObjectProperty, значение которого представляет страницы задания на печать в виде массива 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.
    IntegerProperty copiesProperty()
    IntegerProperty, представляющее количество копий задания на печать.
    Collation getCollation()
    Сортировка определяет, как листы упорядочиваются при печати нескольких копий документа.
    int getCopies()
    Получить количество копий для печати.
    String getJobName()
    Получить имя задания.
    PageLayout getPageLayout()
    Получить текущую компоновку страниц для этого задания.
    PageRange[] getPageRanges()
    Диапазон страниц для печати.
    PaperSource getPaperSource()
    Получить значение свойства paperSource.
    PrintColor getPrintColor()
    Получить значение свойства printColor.
    PrintQuality getPrintQuality()
    Получить значение свойства printQuality.
    PrintResolution getPrintResolution()
    PrintSides getPrintSides()
    Если принтер это поддерживает, то задание может быть напечатано с обеих сторон носителя (бумаги), т. е. печать на двух сторонах.
    StringProperty jobNameProperty()
    StringProperty, представляющее имя задания.
    ObjectProperty<PageLayout> pageLayoutProperty()
    Свойство, представляющее экземпляр PageLayout.
    ObjectProperty pageRangesProperty()
    ObjectProperty, значение которого представляет страницы задания на печать в виде массива PageRange.
    ObjectProperty<PaperSource> paperSourceProperty()
    Свойство, представляющее экземпляр PaperSource.
    ObjectProperty<PrintColor> printColorProperty()
    Свойство, представляющее экземпляр PrintColor.
    ObjectProperty<PrintQuality> printQualityProperty()
    Свойство, представляющее экземпляр PrintQuality.
    ObjectProperty<PrintResolution> printResolutionProperty()
    Свойство, представляющее экземпляр PrintResolution.
    ObjectProperty<PrintSides> printSidesProperty()
    Свойство, представляющее экземпляр PrintSides.
    void setCollation​(Collation collation)
    Установить свойство Collation.
    void setCopies​(int nCopies)
    Установить количество копий для печати.
    void setJobName​(String name)
    Установить имя задания.
    void setPageLayout​(PageLayout pageLayout)
    Установить используемую компоновку страниц.
    void setPageRanges​(PageRange... pages)
    Диапазон страниц для печати в виде массива PageRange.
    void setPaperSource​(PaperSource value)
    Установить значение свойства paperSource.
    void setPrintColor​(PrintColor color)
    Установить свойство PrintColor.
    void setPrintQuality​(PrintQuality quality)
    Установить свойство PrintQuality.
    void setPrintResolution​(PrintResolution resolution)
    Установить свойство PrintResolution.
    void setPrintSides​(PrintSides sides)
    Установить свойство PrintSides, которое управляет двухсторонней печатью.
    String toString()
    • Наследуемые методы из класса java.lang.Object

      clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
  • Подробности свойства

    • 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.
      См. также:
      getPrintResolution(), setPrintResolution(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(), setPrintResolution(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 - Используемый макет страницы.
    • toString

      public String toString()
      Переопределяет:
      toString в классе Object

© 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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API