JobSettings

java.lang.Object
- javafx.print.JobSettings

```
public final class JobSettings
extends java.lang.Object
```
The JobSettings class encapsulates most of the configuration of a print job. Applications do not - and cannot - directly create or set a JobSettings instance. One is already installed on the print job when it is created.
As documented on PrinterJob, the JobSettings installed on that job will initially reflect the current default settings for the initially associated printer for that job.
The JobSettings delegate then remains the same for the life of the job, and will have it's member properties updated to be compatible with a change in Printer on the job. For example as a result of a user interaction via a platform's dialog. An incompatible setting will usually cause the setting to revert to the default for the new printer.
Any implicit or explicit updates to settings resulting from the user interaction with dialog will be propagated and visible to the application once the user approves the settings by dismissing the dialog using its "accept" option.
For most printing applications it is likely sufficient to let the user set the desired options and have these propagated to the job. For applications which need them, there are setter and getter methods for the individual options, which are also available as properties, and change in values of settings may be monitored and updated via these properties.
Not all values of settings are available on all printers. For example a printer may not support two-sided printing. See the Printer class for how to to determine supported settings.

Since:

JavaFX 8.0

Property Summary

All Methods Instance Methods Concrete Methods
Type	Property and Description
`<any>`	`collation` Property representing an instance of `Collation`.
`IntegerProperty`	`copies` `IntegerProperty` representing the number of copies of the job to print.
`StringProperty`	`jobName` `StringProperty` representing the name of a job.
`<any>`	`pageLayout` Property representing an instance of `PageLayout`.
`ObjectProperty`	`pageRanges` An `ObjectProperty` whose value represents the job pages to print as an array of PageRange.
`<any>`	`paperSource` Property representing an instance of `PaperSource`.
`<any>`	`printColor` Property representing an instance of `PrintColor`.
`<any>`	`printQuality` Property representing an instance of `PrintQuality`.
`<any>`	`printResolution` Property representing an instance of `PrintResolution`.
`<any>`	`printSides` Property representing an instance of `PrintSides`.

Field Summary

Fields
Modifier and Type	Field and Description
`private <any>`	`collation`
`private <any>`	`color`
`private IntegerProperty`	`copies`
`private static java.lang.String`	`DEFAULT_JOBNAME`
`private boolean`	`defaultCollation`
`private boolean`	`defaultCopies`
`private boolean`	`defaultPageLayout`
`private boolean`	`defaultPaperSource`
`private boolean`	`defaultPrintColor`
`private boolean`	`defaultPrintQuality`
`private boolean`	`defaultPrintResolution`
`private boolean`	`defaultSides`
`private boolean`	`hasOldCollation`
`private boolean`	`hasOldCopies`
`private boolean`	`hasOldPageLayout`
`private boolean`	`hasOldPaperSource`
`private boolean`	`hasOldPrintColor`
`private boolean`	`hasOldPrintQuality`
`private boolean`	`hasOldPrintResolution`
`private boolean`	`hasOldSides`
`private PrinterJob`	`job`
`private SimpleStringProperty`	`jobName`
`private <any>`	`layout`
`private Collation`	`oldCollation`
`private int`	`oldCopies`
`private PageLayout`	`oldPageLayout`
`private PaperSource`	`oldPaperSource`
`private PrintColor`	`oldPrintColor`
`private PrintQuality`	`oldPrintQuality`
`private PrintResolution`	`oldPrintResolution`
`private PrintSides`	`oldSides`
`private <any>`	`pageRanges`
`private <any>`	`paperSource`
`private Printer`	`printer`
`private PrinterAttributes`	`printerCaps`
`private <any>`	`quality`
`private <any>`	`resolution`
`private <any>`	`sides`

Constructor Summary

Constructors
Constructor and Description

JobSettings(Printer printer)

Constructors
Constructor and Description
`JobSettings(Printer printer)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`<any>`	`collationProperty()` Property representing an instance of `Collation`.
`IntegerProperty`	`copiesProperty()` `IntegerProperty` representing the number of copies of the job to print.
`Collation`	`getCollation()` Collation determines how sheets are sorted when multiple copies of a document are printed.
`int`	`getCopies()` Get the number of copies to print.
`java.lang.String`	`getJobName()` Get the name of a job.
`PageLayout`	`getPageLayout()` Get the current page layout for this job.
`PageRange[]`	`getPageRanges()` The range of pages to print.
`PaperSource`	`getPaperSource()` Gets the value of the property paperSource.
`PrintColor`	`getPrintColor()` Gets the value of the property printColor.
`PrintQuality`	`getPrintQuality()` Gets the value of the property printQuality.
`PrintResolution`	`getPrintResolution()`
`PrintSides`	`getPrintSides()` If a printer supports it, then a job may be printed on both sides of the media (paper), ie duplex printing.
`private boolean`	`isJobNew()`
`StringProperty`	`jobNameProperty()` `StringProperty` representing the name of a job.
`<any>`	`pageLayoutProperty()` Property representing an instance of `PageLayout`.
`ObjectProperty`	`pageRangesProperty()` An `ObjectProperty` whose value represents the job pages to print as an array of PageRange.
`<any>`	`paperSourceProperty()` Property representing an instance of `PaperSource`.
`<any>`	`printColorProperty()` Property representing an instance of `PrintColor`.
`<any>`	`printQualityProperty()` Property representing an instance of `PrintQuality`.
`<any>`	`printResolutionProperty()` Property representing an instance of `PrintResolution`.
`<any>`	`printSidesProperty()` Property representing an instance of `PrintSides`.
`void`	`setCollation(Collation collation)` Set the `Collation` property.
`void`	`setCopies(int nCopies)` Set the number of copies to print.
`void`	`setJobName(java.lang.String name)` Set the name of a job.
`void`	`setPageLayout(PageLayout pageLayout)` Set the PageLayout to use.
`void`	`setPageRanges(PageRange... pages)` The range of pages to print as an array of PageRange.
`void`	`setPaperSource(PaperSource value)` Sets the value of the property paperSource.
`void`	`setPrintColor(PrintColor color)` Set the `PrintColor` property.
`(package private) void`	`setPrinterJob(PrinterJob job)`
`void`	`setPrintQuality(PrintQuality quality)` Set the `PrintQuality` property.
`void`	`setPrintResolution(PrintResolution resolution)` Set the `PrintResolution` property.
`void`	`setPrintSides(PrintSides sides)` Set the `PrintSides` property which controls duplex printing.
`java.lang.String`	`toString()`
`(package private) void`	`updateForPrinter(Printer printer)` If any settings are incompatible with the specified printer, they are updated to be compatible.

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 representing the name of a job.
    
    See Also:
    
    getJobName(), setJobName(String)
  - copies
```
public final IntegerProperty copiesProperty
```
    IntegerProperty representing the number of copies of the job to print.
    
    See Also:
    
    getCopies(), setCopies(int)
  - pageRanges
```
public final ObjectProperty pageRangesProperty
```
    An ObjectProperty whose value represents the job pages to print as an array of PageRange. A null values mean print all pages. Otherwise it must be a non-overlapping array of PageRange instances ordered in increasing page number. Page numbers start from 1 (one). An empty array is considered equivalent to a null array.
    An illegal or unsupported (by the printer) set of page ranges will be ignored.
    Ranges which exceed beyond the number of pages imaged by the job during printing do not cause any error.
    
    See Also:
    
    getPageRanges(), setPageRanges(PageRange[])
  - printSides
```
public final <any> printSidesProperty
```
    Property representing an instance of PrintSides.
    
    See Also:
    
    getPrintSides(), setPrintSides(PrintSides)
  - collation
```
public final <any> collationProperty
```
    Property representing an instance of Collation.
    
    See Also:
    
    getCollation(), setCollation(Collation)
  - printColor
```
public final <any> printColorProperty
```
    Property representing an instance of PrintColor.
    
    See Also:
    
    getPrintColor(), setPrintColor(PrintColor)
  - printQuality
```
public final <any> printQualityProperty
```
    Property representing an instance of PrintQuality.
    
    See Also:
    
    getPrintQuality(), setPrintQuality(PrintQuality)
  - printResolution
```
public final <any> printResolutionProperty
```
    Property representing an instance of PrintResolution.
    
    See Also:
    
    getPrintResolution(), setPrintResolution(PrintResolution)
  - paperSource
```
public final <any> paperSourceProperty
```
    Property representing an instance of PaperSource.
    
    See Also:
    
    getPaperSource(), setPaperSource(PaperSource)
  - pageLayout
```
public final <any> pageLayoutProperty
```
    Property representing an instance of PageLayout.
    
    See Also:
    
    getPageLayout(), setPageLayout(PageLayout)
- Field Detail
  - job
```
private PrinterJob job
```
  - printer
```
private Printer printer
```
  - printerCaps
```
private PrinterAttributes printerCaps
```
  - defaultCopies
```
private boolean defaultCopies
```
  - hasOldCopies
```
private boolean hasOldCopies
```
  - oldCopies
```
private int oldCopies
```
  - defaultSides
```
private boolean defaultSides
```
  - hasOldSides
```
private boolean hasOldSides
```
  - oldSides
```
private PrintSides oldSides
```
  - defaultCollation
```
private boolean defaultCollation
```
  - hasOldCollation
```
private boolean hasOldCollation
```
  - oldCollation
```
private Collation oldCollation
```
  - defaultPrintColor
```
private boolean defaultPrintColor
```
  - hasOldPrintColor
```
private boolean hasOldPrintColor
```
  - oldPrintColor
```
private PrintColor oldPrintColor
```
  - defaultPrintQuality
```
private boolean defaultPrintQuality
```
  - hasOldPrintQuality
```
private boolean hasOldPrintQuality
```
  - oldPrintQuality
```
private PrintQuality oldPrintQuality
```
  - defaultPrintResolution
```
private boolean defaultPrintResolution
```
  - hasOldPrintResolution
```
private boolean hasOldPrintResolution
```
  - oldPrintResolution
```
private PrintResolution oldPrintResolution
```
  - defaultPaperSource
```
private boolean defaultPaperSource
```
  - hasOldPaperSource
```
private boolean hasOldPaperSource
```
  - oldPaperSource
```
private PaperSource oldPaperSource
```
  - defaultPageLayout
```
private boolean defaultPageLayout
```
  - hasOldPageLayout
```
private boolean hasOldPageLayout
```
  - oldPageLayout
```
private PageLayout oldPageLayout
```
  - DEFAULT_JOBNAME
```
private static final java.lang.String DEFAULT_JOBNAME
```
    See Also:
    
    Constant Field Values
  - jobName
```
private SimpleStringProperty jobName
```
  - copies
```
private IntegerProperty copies
```
  - pageRanges
```
private <any> pageRanges
```
  - sides
```
private <any> sides
```
  - collation
```
private <any> collation
```
  - color
```
private <any> color
```
  - quality
```
private <any> quality
```
  - resolution
```
private <any> resolution
```
  - paperSource
```
private <any> paperSource
```
  - layout
```
private <any> layout
```
- Constructor Detail
  - JobSettings
```
JobSettings(Printer printer)
```
- Method Detail
  - setPrinterJob
```
void setPrinterJob(PrinterJob job)
```
  - isJobNew
```
private boolean isJobNew()
```
  - updateForPrinter
```
void updateForPrinter(Printer printer)
```
    If any settings are incompatible with the specified printer, they are updated to be compatible. This method could be useful as a public one.
  - jobNameProperty
```
public final StringProperty jobNameProperty()
```
    StringProperty representing the name of a job.
    
    See Also:
    
    getJobName(), setJobName(String)
  - getJobName
```
public java.lang.String getJobName()
```
    Get the name of a job.
    
    Returns:
    
    a string representing the name of a job
  - setJobName
```
public void setJobName(java.lang.String name)
```
    Set the name of a job.
    
    Parameters:
    
    name - string representing the name of a job
  - copiesProperty
```
public final IntegerProperty copiesProperty()
```
    IntegerProperty representing the number of copies of the job to print.
    
    See Also:
    
    getCopies(), setCopies(int)
  - getCopies
```
public int getCopies()
```
    Get the number of copies to print.
    
    Returns:
    
    number of copies to print
  - setCopies
```
public final void setCopies(int nCopies)
```
    Set the number of copies to print.
    
    Parameters:
    
    nCopies - number of copies to print
  - pageRangesProperty
```
public final ObjectProperty pageRangesProperty()
```
    An ObjectProperty whose value represents the job pages to print as an array of PageRange. A null values mean print all pages. Otherwise it must be a non-overlapping array of PageRange instances ordered in increasing page number. Page numbers start from 1 (one). An empty array is considered equivalent to a null array.
    An illegal or unsupported (by the printer) set of page ranges will be ignored.
    Ranges which exceed beyond the number of pages imaged by the job during printing do not cause any error.
    
    See Also:
    
    getPageRanges(), setPageRanges(PageRange[])
  - getPageRanges
```
public PageRange[] getPageRanges()
```
    The range of pages to print. null always means all pages. See pageRangesProperty for more details.
    
    Returns:
    
    null or an array as specified above
  - setPageRanges
```
public void setPageRanges(PageRange... pages)
```
    The range of pages to print as an array of PageRange. The use of varargs means the common case of a single range can be auto-boxed. ((PageRange[])null) always means all pages however since this is the default it is less likely to be used. See pageRangesProperty for more details.
    
    Parameters:
    
    pages - null or a varargs array as specified above
  - printSidesProperty
```
public final <any> printSidesProperty()
```
    Property representing an instance of PrintSides.
    
    See Also:
    
    getPrintSides(), setPrintSides(PrintSides)
  - getPrintSides
```
public PrintSides getPrintSides()
```
    If a printer supports it, then a job may be printed on both sides of the media (paper), ie duplex printing. This method returns the selected setting.
    
    Returns:
    
    the duplex (side) setting.
  - setPrintSides
```
public void setPrintSides(PrintSides sides)
```
    Set the PrintSides property which controls duplex printing. A null value is ignored.
    
    Parameters:
    
    sides - new setting for number of sides.
  - collationProperty
```
public final <any> collationProperty()
```
    Property representing an instance of Collation.
    
    See Also:
    
    getCollation(), setCollation(Collation)
  - getCollation
```
public Collation getCollation()
```
    Collation determines how sheets are sorted when multiple copies of a document are printed. As such it is only relevant if 2 or more copies of a document with 2 more sheets are printed. A sheet is the physical media, so documents with 2 pages that are printed N-up, or double-sided may still have only one sheet. A collated print job produces documents with sheets of a document sorted in sequence. An uncollated job collects together the multiple copies of the same sheet. Uncollated (false) is the typical default value.
    
    Returns:
    
    the collation
  - setCollation
```
public void setCollation(Collation collation)
```
    Set the Collation property. A null value is ignored.
    
    Parameters:
    
    collation - new setting for collation
  - printColorProperty
```
public final <any> printColorProperty()
```
    Property representing an instance of PrintColor.
    
    See Also:
    
    getPrintColor(), setPrintColor(PrintColor)
  - getPrintColor
```
public PrintColor getPrintColor()
```
    Gets the value of the property printColor.
  - setPrintColor
```
public void setPrintColor(PrintColor color)
```
    Set the PrintColor property. A null value is ignored.
    
    Parameters:
    
    color - new setting for print color.
  - printQualityProperty
```
public final <any> printQualityProperty()
```
    Property representing an instance of PrintQuality.
    
    See Also:
    
    getPrintQuality(), setPrintQuality(PrintQuality)
  - getPrintQuality
```
public PrintQuality getPrintQuality()
```
    Gets the value of the property printQuality.
  - setPrintQuality
```
public void setPrintQuality(PrintQuality quality)
```
    Set the PrintQuality property. A null value is ignored.
    Note that quality and resolution overlapping concepts. Therefore a printer may support setting one, or the other but not both. Applications setting these programmatically should query both properties and select appropriately from the supported values. If a printer supports non-standard values, code likely cannot distinguish the printer's interpretation of these values and is safest to stick to selecting from the standard value that matches the requirement.
    
    Parameters:
    
    quality - new setting for print quality.
  - printResolutionProperty
```
public final <any> printResolutionProperty()
```
    Property representing an instance of PrintResolution.
    
    See Also:
    
    getPrintResolution(), setPrintResolution(PrintResolution)
  - getPrintResolution
```
public PrintResolution getPrintResolution()
```
    Returns:
    
    the print resolution
  - setPrintResolution
```
public void setPrintResolution(PrintResolution resolution)
```
    Set the PrintResolution property. A null value is ignored.
    Note that quality and resolution overlapping concepts. Therefore a printer may support setting one, or the other but not both. Applications setting these programmatically should query both properties and select appropriately from the supported values. If a printer supports non-standard values, code likely cannot distinguish the printer's interpretation of these values and is safest to stick to selecting from the standard value that matches the requirement.
    
    Parameters:
    
    resolution - new setting for print resolution.
  - paperSourceProperty
```
public final <any> paperSourceProperty()
```
    Property representing an instance of PaperSource.
    
    See Also:
    
    getPaperSource(), setPaperSource(PaperSource)
  - getPaperSource
```
public PaperSource getPaperSource()
```
    Gets the value of the property paperSource.
  - setPaperSource
```
public void setPaperSource(PaperSource value)
```
    Sets the value of the property paperSource.
  - pageLayoutProperty
```
public final <any> pageLayoutProperty()
```
    Property representing an instance of PageLayout.
    
    See Also:
    
    getPageLayout(), setPageLayout(PageLayout)
  - getPageLayout
```
public PageLayout getPageLayout()
```
    Get the current page layout for this job.
    
    Returns:
    
    page layout to use for the job.
  - setPageLayout
```
public void setPageLayout(PageLayout pageLayout)
```
    Set the PageLayout to use.
    
    Parameters:
    
    pageLayout - The page layout to use.
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object

Class JobSettings

Property Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Property Detail

jobName

copies

pageRanges

printSides

collation

printColor

printQuality

printResolution

paperSource

pageLayout

Field Detail

job

printer

printerCaps

defaultCopies

hasOldCopies

oldCopies

defaultSides

hasOldSides

oldSides

defaultCollation

hasOldCollation

oldCollation

defaultPrintColor

hasOldPrintColor

oldPrintColor

defaultPrintQuality

hasOldPrintQuality

oldPrintQuality

defaultPrintResolution

hasOldPrintResolution

oldPrintResolution

defaultPaperSource

hasOldPaperSource

oldPaperSource

defaultPageLayout

hasOldPageLayout

oldPageLayout

DEFAULT_JOBNAME

jobName

copies

pageRanges

sides

collation

color

quality

resolution

paperSource

layout

Constructor Detail

JobSettings

Method Detail

setPrinterJob

isJobNew

updateForPrinter

jobNameProperty

getJobName

setJobName

copiesProperty

getCopies

setCopies

pageRangesProperty

getPageRanges

setPageRanges

printSidesProperty

getPrintSides

setPrintSides

collationProperty

getCollation

setCollation

printColorProperty

getPrintColor

setPrintColor