Spec-Zone.ru › OpenJavaFX 8
javafx.print

Класс JobSettings

java.lang.Object
  • javafx.print.JobSettings

public final class JobSettings
extends Object
Класс JobSettings инкапсулирует большинство настроек задания печати. Приложения не могут и не должны напрямую создавать или устанавливать экземпляр JobSettings. Такой экземпляр уже установлен в задании печати при его создании.

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

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

Любые неявные или явные обновления настроек, возникающие в результате взаимодействия пользователя с диалоговым окном, будут распространены и видны приложению, как только пользователь одобрит настройки, закрыв диалоговое окно с помощью опции «принять».

Для большинства приложений печати, вероятно, достаточно позволить пользователю задать нужные параметры и передать их заданию. Для приложений, которым они нужны, существуют методы set и get для отдельных параметров, которые также доступны в виде свойств, и изменения значений настроек могут отслеживаться и обновляться с помощью этих свойств.

Не все значения настроек доступны на всех принтерах. Например, принтер может не поддерживать двустороннюю печать. Обратитесь к классу Printer, чтобы узнать, как определить поддерживаемые настройки.

С:

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)

  • Подробное описание методов

    • 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-up или двусторонней печати, могут иметь только один лист. Сортировка задания печати создает документы с листами документа, отсортированными последовательно. Несортированная работа собирает вместе несколько копий одного и того же листа. Несортированная печать (false) is the typical default value.

    • 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 для использования.

      Параметры:

      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