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
TypePropertyDescriptionfinal ObjectProperty<Collation>
Property representing an instance ofCollation
.final IntegerProperty
IntegerProperty
representing the number of copies of the job to print.final StringProperty
StringProperty
representing the name of a job.final StringProperty
AStringProperty
representing the name of a filesystem file, to which the platform printer driver should spool the rendered print data.final ObjectProperty<PageLayout>
Property representing an instance ofPageLayout
.final ObjectProperty
AnObjectProperty
whose value represents the job pages to print as an array of PageRange.final ObjectProperty<PaperSource>
Property representing an instance ofPaperSource
.final ObjectProperty<PrintColor>
Property representing an instance ofPrintColor
.final ObjectProperty<PrintQuality>
Property representing an instance ofPrintQuality
.final ObjectProperty<PrintResolution>
Property representing an instance ofPrintResolution
.final ObjectProperty<PrintSides>
Property representing an instance ofPrintSides
. -
Method Summary
Modifier and TypeMethodDescriptionfinal ObjectProperty<Collation>
Property representing an instance ofCollation
.final IntegerProperty
IntegerProperty
representing the number of copies of the job to print.final Collation
Gets the value of the property collation.final int
Gets the value of the property copies.final String
Gets the value of the property jobName.final String
Gets the value of the property outputFile.final PageLayout
Gets the value of the property pageLayout.final PageRange[]
Gets the value of the property pageRanges.final PaperSource
Gets the value of the property paperSource.final PrintColor
Gets the value of the property printColor.final PrintQuality
Gets the value of the property printQuality.final PrintResolution
Gets the value of the property printResolution.final PrintSides
Gets the value of the property printSides.final StringProperty
StringProperty
representing the name of a job.final StringProperty
AStringProperty
representing the name of a filesystem file, to which the platform printer driver should spool the rendered print data.final ObjectProperty<PageLayout>
Property representing an instance ofPageLayout
.final ObjectProperty
AnObjectProperty
whose value represents the job pages to print as an array of PageRange.final ObjectProperty<PaperSource>
Property representing an instance ofPaperSource
.final ObjectProperty<PrintColor>
Property representing an instance ofPrintColor
.final ObjectProperty<PrintQuality>
Property representing an instance ofPrintQuality
.final ObjectProperty<PrintResolution>
Property representing an instance ofPrintResolution
.final ObjectProperty<PrintSides>
Property representing an instance ofPrintSides
.final void
setCollation
(Collation collation) Sets the value of the property collation.final void
setCopies
(int nCopies) Sets the value of the property copies.final void
setJobName
(String name) Sets the value of the property jobName.final void
setOutputFile
(String filePath) Sets the value of the property outputFile.final void
setPageLayout
(PageLayout pageLayout) Sets the value of the property pageLayout.final void
setPageRanges
(PageRange... pages) The range of pages to print as an array of PageRange.final void
setPaperSource
(PaperSource value) Sets the value of the property paperSource.final void
setPrintColor
(PrintColor color) Sets the value of the property printColor.final void
setPrintQuality
(PrintQuality quality) Sets the value of the property printQuality.final void
setPrintResolution
(PrintResolution resolution) Sets the value of the property printResolution.final void
setPrintSides
(PrintSides sides) Sets the value of the property printSides.
-
Property Details
-
jobName
StringProperty
representing the name of a job.- See Also:
-
outputFile
AStringProperty
representing the name of a filesystem file, to which the platform printer driver should spool the rendered print data.Applications can use this to programmatically request print-to-file behavior where the native print system is capable of spooling the output to a filesystem file, rather than the printer device.
This is often useful where the printer driver generates a format such as Postscript or PDF, and the application intends to distribute the result instead of printing it, or for some other reason the application does not want physical media (paper) emitted by the printer.
The default value is an empty string, which is interpreted as unset, equivalent to null, which means output is sent to the printer. So in order to reset to print to the printer, clear the value of this property by setting it to null or an empty string.
Additionally if the application displays a printer dialog which allows the user to specify a file destination, including altering an application specified file destination, the value of this property will reflect that user-specified choice, including clearing it to reset to print to the printer, if the user does so.
If the print system does not support print-to-file, then this setting will be ignored.
If the specified name specifies a non-existent path, or does not specify a user writable file, when printing the results are platform-dependent. Possible behaviours might include replacement with a default output file location, printing to the printer instead, or a platform printing error. If a
SecurityManager
is installed and it denies access to the specified file aSecurityException
may be thrown.- Default value:
- an empty string
- Since:
- 17
- See Also:
-
copies
IntegerProperty
representing the number of copies of the job to print.- See Also:
-
pageRanges
AnObjectProperty
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:
-
printSides
Property representing an instance ofPrintSides
.- See Also:
-
collation
Property representing an instance ofCollation
. 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.- See Also:
-
printColor
Property representing an instance ofPrintColor
. If a null value is set it is ignored.- See Also:
-
printQuality
Property representing an instance ofPrintQuality
.Note that quality and resolution are 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 it is safest to stick to selecting a standard value that matches the requirement.
-
printResolution
Property representing an instance ofPrintResolution
. A null value is ignored.Note that quality and resolution are 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 it is safest to stick to selecting a standard value that matches the requirement.
-
paperSource
Property representing an instance ofPaperSource
. A null value is ignored.- See Also:
-
pageLayout
Property representing an instance ofPageLayout
. Setting a null value is ignored.- See Also:
-
-
Method Details
-
jobNameProperty
StringProperty
representing the name of a job.- See Also:
-
getJobName
Gets the value of the property jobName.- Property description:
StringProperty
representing the name of a job.
-
setJobName
Sets the value of the property jobName.- Property description:
StringProperty
representing the name of a job.
-
outputFileProperty
AStringProperty
representing the name of a filesystem file, to which the platform printer driver should spool the rendered print data.Applications can use this to programmatically request print-to-file behavior where the native print system is capable of spooling the output to a filesystem file, rather than the printer device.
This is often useful where the printer driver generates a format such as Postscript or PDF, and the application intends to distribute the result instead of printing it, or for some other reason the application does not want physical media (paper) emitted by the printer.
The default value is an empty string, which is interpreted as unset, equivalent to null, which means output is sent to the printer. So in order to reset to print to the printer, clear the value of this property by setting it to null or an empty string.
Additionally if the application displays a printer dialog which allows the user to specify a file destination, including altering an application specified file destination, the value of this property will reflect that user-specified choice, including clearing it to reset to print to the printer, if the user does so.
If the print system does not support print-to-file, then this setting will be ignored.
If the specified name specifies a non-existent path, or does not specify a user writable file, when printing the results are platform-dependent. Possible behaviours might include replacement with a default output file location, printing to the printer instead, or a platform printing error. If a
SecurityManager
is installed and it denies access to the specified file aSecurityException
may be thrown.- Default value:
- an empty string
- Since:
- 17
- See Also:
-
getOutputFile
Gets the value of the property outputFile.- Property description:
- A
StringProperty
representing the name of a filesystem file, to which the platform printer driver should spool the rendered print data.Applications can use this to programmatically request print-to-file behavior where the native print system is capable of spooling the output to a filesystem file, rather than the printer device.
This is often useful where the printer driver generates a format such as Postscript or PDF, and the application intends to distribute the result instead of printing it, or for some other reason the application does not want physical media (paper) emitted by the printer.
The default value is an empty string, which is interpreted as unset, equivalent to null, which means output is sent to the printer. So in order to reset to print to the printer, clear the value of this property by setting it to null or an empty string.
Additionally if the application displays a printer dialog which allows the user to specify a file destination, including altering an application specified file destination, the value of this property will reflect that user-specified choice, including clearing it to reset to print to the printer, if the user does so.
If the print system does not support print-to-file, then this setting will be ignored.
If the specified name specifies a non-existent path, or does not specify a user writable file, when printing the results are platform-dependent. Possible behaviours might include replacement with a default output file location, printing to the printer instead, or a platform printing error. If a
SecurityManager
is installed and it denies access to the specified file aSecurityException
may be thrown. - Default value:
- an empty string
- Since:
- 17
-
setOutputFile
Sets the value of the property outputFile.- Property description:
- A
StringProperty
representing the name of a filesystem file, to which the platform printer driver should spool the rendered print data.Applications can use this to programmatically request print-to-file behavior where the native print system is capable of spooling the output to a filesystem file, rather than the printer device.
This is often useful where the printer driver generates a format such as Postscript or PDF, and the application intends to distribute the result instead of printing it, or for some other reason the application does not want physical media (paper) emitted by the printer.
The default value is an empty string, which is interpreted as unset, equivalent to null, which means output is sent to the printer. So in order to reset to print to the printer, clear the value of this property by setting it to null or an empty string.
Additionally if the application displays a printer dialog which allows the user to specify a file destination, including altering an application specified file destination, the value of this property will reflect that user-specified choice, including clearing it to reset to print to the printer, if the user does so.
If the print system does not support print-to-file, then this setting will be ignored.
If the specified name specifies a non-existent path, or does not specify a user writable file, when printing the results are platform-dependent. Possible behaviours might include replacement with a default output file location, printing to the printer instead, or a platform printing error. If a
SecurityManager
is installed and it denies access to the specified file aSecurityException
may be thrown. - Default value:
- an empty string
- Since:
- 17
-
copiesProperty
IntegerProperty
representing the number of copies of the job to print.- See Also:
-
getCopies
public final int getCopies()Gets the value of the property copies.- Property description:
IntegerProperty
representing the number of copies of the job to print.
-
setCopies
public final void setCopies(int nCopies) Sets the value of the property copies.- Property description:
IntegerProperty
representing the number of copies of the job to print.
-
pageRangesProperty
AnObjectProperty
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
Gets the value of the property pageRanges.- Property description:
- 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.
-
setPageRanges
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. SeepageRangesProperty()
for more details.- Parameters:
pages
- null or a varargs array as specified above
-
printSidesProperty
Property representing an instance ofPrintSides
.- See Also:
-
getPrintSides
Gets the value of the property printSides.- Property description:
- Property representing an instance of
PrintSides
.
-
setPrintSides
Sets the value of the property printSides.- Property description:
- Property representing an instance of
PrintSides
.
-
collationProperty
Property representing an instance ofCollation
. 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.- See Also:
-
getCollation
Gets the value of the property collation.- Property description:
- Property representing an instance of
Collation
. 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.
-
setCollation
Sets the value of the property collation.- Property description:
- Property representing an instance of
Collation
. 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.
-
printColorProperty
Property representing an instance ofPrintColor
. If a null value is set it is ignored.- See Also:
-
getPrintColor
Gets the value of the property printColor.- Property description:
- Property representing an instance of
PrintColor
. If a null value is set it is ignored.
-
setPrintColor
Sets the value of the property printColor.- Property description:
- Property representing an instance of
PrintColor
. If a null value is set it is ignored.
-
printQualityProperty
Property representing an instance ofPrintQuality
.Note that quality and resolution are 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 it is safest to stick to selecting a standard value that matches the requirement.
-
getPrintQuality
Gets the value of the property printQuality.- Property description:
- Property representing an instance of
PrintQuality
.Note that quality and resolution are 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 it is safest to stick to selecting a standard value that matches the requirement.
-
setPrintQuality
Sets the value of the property printQuality.- Property description:
- Property representing an instance of
PrintQuality
.Note that quality and resolution are 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 it is safest to stick to selecting a standard value that matches the requirement.
-
printResolutionProperty
Property representing an instance ofPrintResolution
. A null value is ignored.Note that quality and resolution are 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 it is safest to stick to selecting a standard value that matches the requirement.
-
getPrintResolution
Gets the value of the property printResolution.- Property description:
- Property representing an instance of
PrintResolution
. A null value is ignored.Note that quality and resolution are 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 it is safest to stick to selecting a standard value that matches the requirement.
-
setPrintResolution
Sets the value of the property printResolution.- Property description:
- Property representing an instance of
PrintResolution
. A null value is ignored.Note that quality and resolution are 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 it is safest to stick to selecting a standard value that matches the requirement.
-
paperSourceProperty
Property representing an instance ofPaperSource
. A null value is ignored.- See Also:
-
getPaperSource
Gets the value of the property paperSource.- Property description:
- Property representing an instance of
PaperSource
. A null value is ignored.
-
setPaperSource
Sets the value of the property paperSource.- Property description:
- Property representing an instance of
PaperSource
. A null value is ignored.
-
pageLayoutProperty
Property representing an instance ofPageLayout
. Setting a null value is ignored.- See Also:
-
getPageLayout
Gets the value of the property pageLayout.- Property description:
- Property representing an instance of
PageLayout
. Setting a null value is ignored.
-
setPageLayout
Sets the value of the property pageLayout.- Property description:
- Property representing an instance of
PageLayout
. Setting a null value is ignored.
-