java.lang.Object
- javafx.print.JobSettings

```
public final class JobSettings
extends Object
```
JobSettings类封装了打印作业的大部分配置。应用程序不 - 也不能 - 直接创建或设置JobSettings实例。打印作业创建后已经安装了一个。
如PrinterJob上所述，安装在该作业上的JobSettings将初始反映该作业最初关联的打印机的当前默认设置。

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

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

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

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

从以下版本开始：

JavaFX 8.0

Property Summary

Properties
Type	Property	描述
`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`一个实例。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	方法	描述
`ObjectProperty<Collation>`	`collationProperty()`	属性代表 `Collation` 。
`IntegerProperty`	`copiesProperty()`	`IntegerProperty`代表要打印的作业的份数。
`Collation`	`getCollation()`	排序规则确定打印文档的多个副本时如何排序纸张。
`int`	`getCopies()`	获取要打印的份数。
`String`	`getJobName()`	获取工作的名称。
`PageLayout`	`getPageLayout()`	获取此作业的当前页面布局。
`PageRange[]`	`getPageRanges()`	要打印的页面范围。 null始终表示所有页面。
`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)`	将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()`	返回对象的字符串表示形式。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Property Detail
  - jobName
```
public final StringProperty jobNameProperty
```
    StringProperty表示作业的名称。
    
    另请参见：
    
    getJobName() ， setJobName(String)
  - copies
```
public final IntegerProperty copiesProperty
```
    IntegerProperty表示要打印的作业的份数。
    
    另请参见：
    
    getCopies() ， setCopies(int)
  - pageRanges
```
public final ObjectProperty pageRangesProperty
```
    一个ObjectProperty其值表示作为PageRange数组打印的作业页面。空值表示打印所有页面。否则，它必须是一个不重叠的PageRange实例数组，按增加页码排序。页数从1（一）开始。空数组被认为等同于一个空数组。
    非法或不支持（由打印机）设置的页面范围将被忽略。
    
    超过在打印期间由作业成像的页数超过的范围不会引起任何错误。
    
    另请参见：
    
    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数组打印的作业页面。空值表示打印所有页面。否则，它必须是一个不重叠的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数组
  - printSidesProperty
```
public final ObjectProperty<PrintSides> printSidesProperty()
```
    属性代表 PrintSides 。
    
    另请参见：
    
    getPrintSides() ， setPrintSides(PrintSides)
  - getPrintSides
```
public PrintSides getPrintSides()
```
    如果打印机支持它，则可以在介质（纸张）的两面上打印作业，即双面打印。此方法返回所选设置。
    
    结果
    
    双面（侧）设置。
  - setPrintSides
```
public void setPrintSides(PrintSides sides)
```
    设置控制双面打印的PrintSides属性。将忽略空值。
    
    参数
    
    sides - 双面数量的新设置。
  - collationProperty
```
public final ObjectProperty<Collation> collationProperty()
```
    属性代表 Collation一个实例。
    
    另请参见：
    
    getCollation() ， setCollation(Collation)
  - getCollation
```
public Collation getCollation()
```
    排序规则确定打印文档的多个副本时如何排序纸张。因此，如果打印了2张以上的两张以上的文件副本，则仅有相关性。一张纸是物理介质，所以打印为N页或双面的2页的文档可能仍然只有一张。整理的打印作业将生成具有按顺序排列的文档的文档的文档。未分类的工作一起收集同一张纸的多份副本。未分类（ false ）是典型的默认值。
    
    结果
    
    整理
  - setCollation
```
public void setCollation(Collation collation)
```
    设置Collation属性。将忽略空值。
    
    参数
    
    collation - 排序 collation新设置
  - printColorProperty
```
public final ObjectProperty<PrintColor> printColorProperty()
```
    属性代表 PrintColor一个实例。
    
    另请参见：
    
    getPrintColor() ， setPrintColor(PrintColor)
  - getPrintColor
```
public PrintColor getPrintColor()
```
    获取属性printColor的值。
    
    Property description:
    
    属性代表 PrintColor一个实例。
  - setPrintColor
```
public void setPrintColor(PrintColor color)
```
    设置PrintColor属性。将忽略空值。
    
    参数
    
    color - 打印颜色的新设置。
  - printQualityProperty
```
public final ObjectProperty<PrintQuality> printQualityProperty()
```
    物业代表 PrintQuality 。
    
    另请参见：
    
    getPrintQuality() ， setPrintQuality(PrintQuality)
  - getPrintQuality
```
public PrintQuality getPrintQuality()
```
    获取属性printQuality的值。
    
    Property description:
    
    属性代表 PrintQuality一个实例。
  - setPrintQuality
```
public void setPrintQuality(PrintQuality quality)
```
    设置PrintQuality属性。将忽略空值。
    注意质量和分辨率重叠的概念。因此，打印机可以支持设置一个或另一个但不是两者。以编程方式设置的应用程序应该查询两个属性，并从支持的值中进行适当的选择。如果打印机支持非标准值，则代码可能无法区分打印机对这些值的解释，并且最符合选择符合要求的标准值。
    
    参数
    
    quality - 打印质量的新设置。
  - printResolutionProperty
```
public final ObjectProperty<PrintResolution> printResolutionProperty()
```
    属性代表 PrintResolution一个实例。
    
    另请参见：
    
    getPrintResolution() ， setPrintResolution(PrintResolution)
  - getPrintResolution
```
public PrintResolution getPrintResolution()
```
    结果
    
    打印分辨率
  - setPrintResolution
```
public void setPrintResolution(PrintResolution resolution)
```
    设置PrintResolution属性。将忽略空值。
    注意质量和分辨率重叠的概念。因此，打印机可以支持设置一个或另一个但不是两者。以编程方式设置的应用程序应该查询两个属性，并从支持的值中进行适当的选择。如果打印机支持非标准值，则代码可能无法区分打印机对这些值的解释，并且最符合选择符合要求的标准值。
    
    参数
    
    resolution - 打印分辨率的新设置。
  - paperSourceProperty
```
public final ObjectProperty<PaperSource> paperSourceProperty()
```
    属性代表 PaperSource一个实例。
    
    另请参见：
    
    getPaperSource() ， setPaperSource(PaperSource)
  - getPaperSource
```
public PaperSource getPaperSource()
```
    获取属性paperSource的值。
    
    Property description:
    
    属性代表 PaperSource一个实例。
  - setPaperSource
```
public void setPaperSource(PaperSource value)
```
    设置属性paperSource的值。
    
    Property description:
    
    属性代表 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()
```
    描述从类别复制： Object
    返回对象的字符串表示形式。一般来说， toString方法返回一个字符串“ toString代表”这个对象。结果应该是一个简明扼要的表达，容易让人阅读。建议所有子类覆盖此方法。
    该toString类方法Object返回一个由类的名称，其中所述对象是其实例，该符号字符`的字符串@ ”，并且对象的哈希码的无符号的十六进制表示。换句话说，这个方法返回一个等于下列值的字符串：
    
    getClass().getName() + '@' + Integer.toHexString(hashCode())
    重写：
    
    toString在 Object
    
    结果
    
    对象的字符串表示形式。

Class JobSettings

Property Summary

方法摘要

Methods inherited from class java.lang.Object

Property Detail

jobName

copies

pageRanges

printSides

collation

printColor

printQuality

printResolution

paperSource

pageLayout

方法详细信息

jobNameProperty

getJobName

setJobName

copiesProperty

getCopies

setCopies

pageRangesProperty

getPageRanges

setPageRanges

printSidesProperty

getPrintSides

setPrintSides

collationProperty

getCollation

setCollation

printColorProperty

getPrintColor

setPrintColor

printQualityProperty

getPrintQuality

setPrintQuality

printResolutionProperty

getPrintResolution

setPrintResolution

paperSourceProperty

getPaperSource

setPaperSource

pageLayoutProperty

getPageLayout

setPageLayout

toString