Module  javafx.graphics
软件包  javafx.print

Class JobSettings



  • public final class JobSettings
    extends Object
    JobSettings类封装了打印作业的大部分配置。 应用程序不 - 也不能 - 直接创建或设置JobSettings实例。 打印作业创建后已经安装了一个。

    如PrinterJob上所述,安装在该作业上的JobSettings将初始反映该作业最初关联的打印机的当前默认设置。

    JobSettings代表在作业的整个生命周期中保持不变,并且将其更新的成员属性与工作中的Printer中的更改兼容。 例如,作为通过平台对话框进行用户交互的结果。 不兼容的设置通常会导致设置恢复为新打印机的默认设置。

    一旦用户通过使用“接受”选项关闭对话框来批准设置,对用户与对话框交互产生的设置的任何隐式或显式更新将被传播并可见。

    对于大多数打印应用程序,让用户设置所需的选项并将其传播到作业可能就足够了。 对于需要它们的应用程序,有各种选项的setter和getter方法,也可以作为属性使用,并且可以通过这些属性监视和更新设置值的更改。

    并非所有打印机都提供所有设置值。 例如,打印机可能不支持双面打印。 有关如何确定支持的设置,请参阅Printer课程。

    从以下版本开始:
    JavaFX 8.0
    • 方法详细信息

      • getJobName

        public String getJobName​()
        获取工作的名称。
        结果
        一个表示作业名称的字符串
      • setJobName

        public void setJobName​(String name)
        设置工作的名称。
        参数
        name - 表示作业名称的字符串
      • getCopies

        public int getCopies​()
        获取要打印的份数。
        结果
        要打印的份数
      • setCopies

        public final void setCopies​(int nCopies)
        设置要打印的份数。
        参数
        nCopies - 要打印的份数
      • pageRangesProperty

        public final ObjectProperty pageRangesProperty​()
        一个ObjectProperty其值表示作为PageRange数组打印的作业页面。 空值表示打印所有页面。 否则,它必须是一个不重叠的PageRange实例数组,按增加页码排序。 页数从1(一)开始。 空数组被认为等同于一个空数组。

        非法或不支持(由打印机)设置的页面范围将被忽略。

        超过在打印期间由作业成像的页数超过的范围不会引起任何错误。

        另请参见:
        getPageRanges()setPageRanges(PageRange[])
      • getPageRanges

        public PageRange[] getPageRanges​()
        要打印的页面范围。 null始终表示所有页面。 详见pageRangesProperty()
        结果
        null或上面指定的数组
      • setPageRanges

        public void setPageRanges​(PageRange... pages)
        要打印为PageRange数组的页面范围。 使用varargs意味着一个单一范围的常见情况可以自动装箱。 ((PageRange[])null)总是意味着所有页面,因为这是默认值,它不太可能被使用。 详见pageRangesProperty()
        参数
        pages - null或上面指定的varargs数组
      • getPrintSides

        public PrintSides getPrintSides​()
        如果打印机支持它,则可以在介质(纸张)的两面上打印作业,即双面打印。 此方法返回所选设置。
        结果
        双面(侧)设置。
      • setPrintSides

        public void setPrintSides​(PrintSides sides)
        设置控制双面打印的PrintSides属性。 将忽略空值。
        参数
        sides - 双面数量的新设置。
      • getCollation

        public Collation getCollation​()
        排序规则确定打印文档的多个副本时如何排序纸张。 因此,如果打印了2张以上的两张以上的文件副本,则仅有相关性。 一张纸是物理介质,所以打印为N页或双面的2页的文档可能仍然只有一张。 整理的打印作业将生成具有按顺序排列的文档的文档的文档。 未分类的工作一起收集同一张纸的多份副本。 未分类( false )是典型的默认值。
        结果
        整理
      • setCollation

        public void setCollation​(Collation collation)
        设置Collation属性。 将忽略空值。
        参数
        collation - 排序 collation新设置
      • getPrintColor

        public PrintColor getPrintColor​()
        获取属性printColor的值。
        Property description:
        属性代表 PrintColor一个实例。
      • setPrintColor

        public void setPrintColor​(PrintColor color)
        设置PrintColor属性。 将忽略空值。

        参数
        color - 打印颜色的新设置。
      • getPrintQuality

        public PrintQuality getPrintQuality​()
        获取属性printQuality的值。
        Property description:
        属性代表 PrintQuality一个实例。
      • setPrintQuality

        public void setPrintQuality​(PrintQuality quality)
        设置PrintQuality属性。 将忽略空值。

        注意质量和分辨率重叠的概念。 因此,打印机可以支持设置一个或另一个但不是两者。 以编程方式设置的应用程序应该查询两个属性,并从支持的值中进行适当的选择。 如果打印机支持非标准值,则代码可能无法区分打印机对这些值的解释,并且最符合选择符合要求的标准值。

        参数
        quality - 打印质量的新设置。
      • getPrintResolution

        public PrintResolution getPrintResolution​()
        结果
        打印分辨率
      • setPrintResolution

        public void setPrintResolution​(PrintResolution resolution)
        设置PrintResolution属性。 将忽略空值。

        注意质量和分辨率重叠的概念。 因此,打印机可以支持设置一个或另一个但不是两者。 以编程方式设置的应用程序应该查询两个属性,并从支持的值中进行适当的选择。 如果打印机支持非标准值,则代码可能无法区分打印机对这些值的解释,并且最符合选择符合要求的标准值。

        参数
        resolution - 打印分辨率的新设置。
      • getPaperSource

        public PaperSource getPaperSource​()
        获取属性paperSource的值。
        Property description:
        属性代表 PaperSource一个实例。
      • setPaperSource

        public void setPaperSource​(PaperSource value)
        设置属性paperSource的值。
        Property description:
        属性代表 PaperSource一个实例。
      • getPageLayout

        public PageLayout getPageLayout​()
        获取此作业的当前页面布局。
        结果
        页面布局用于作业。
      • setPageLayout

        public void setPageLayout​(PageLayout pageLayout)
        将PageLayout设置为使用。
        参数
        pageLayout - 要使用的页面布局。
      • toString

        public String toString​()
        描述从类别复制: Object
        返回对象的字符串表示形式。 一般来说, toString方法返回一个字符串“ toString代表”这个对象。 结果应该是一个简明扼要的表达,容易让人阅读。 建议所有子类覆盖此方法。

        toString类方法Object返回一个由类的名称,其中所述对象是其实例,该符号字符`的字符串@ ”,并且对象的哈希码的无符号的十六进制表示。 换句话说,这个方法返回一个等于下列值的字符串:

         getClass().getName() + '@' + Integer.toHexString(hashCode())
         
        重写:
        toStringObject
        结果
        对象的字符串表示形式。