- java.lang.Object
- 
- javafx.print.JobSettings
 
- 
 public final class JobSettings extends Object JobSettingsクラスは、印刷ジョブの構成のほとんどをカプセル化します。 アプリケーションでJobSettingsインスタンスのセットを直接作成したり設定したりすることはありません(できません)。 印刷ジョブが作成された時点で、すでにそのジョブに1つインストールされています。PrinterJobの説明にあるように、そのジョブにインストールされたJobSettingsは当初、そのジョブに当初関連付けられているプリンタの現在のデフォルト設定を反映しています。 JobSettingsの委譲はジョブが存在する間変わらず、そのメンバー・プロパティはジョブのPrinterの変更と互換性を持たせるように更新されます。 たとえば、プラットフォームのダイアログを介したユーザー操作の結果として、などです。 設定に互換性がない場合、新しいプリンタの設定は通常、デフォルトに戻ります。 ダイアログでのユーザー操作によって、設定が暗黙的または明示的に更新された場合、ユーザーが「確定」オプションを使用してダイアログを終了することで設定を承認すると、更新内容がアプリケーションに伝播されて参照可能になります。 ほとんどの印刷アプリケーションでは、ユーザーが目的のオプションを設定できて、そのオプションがジョブに伝播されれば十分であると考えられます。 これを必要とするアプリケーション用に、個々のオプションに対してsetterおよびgetterメソッド(プロパティとしても使用可能)が用意されており、設定値の変更はこれらのプロパティを介して監視および更新できます。 すべての設定値がすべてのプリンタで使用できるわけではありません。 たとえば、両面印刷をサポートしていないプリンタもあります。 サポートされる設定の判別方法については、 Printerクラスを参照してください。- 導入されたバージョン:
- JavaFX 8.0
 
- 
- 
プロパティのサマリープロパティ 型 プロパティ 説明 ObjectProperty<Collation>collationCollationのインスタンスを表すプロパティ。IntegerPropertycopiesジョブの印刷部数を表すIntegerProperty。StringPropertyjobNameジョブの名前を表すStringProperty。ObjectProperty<PageLayout>pageLayoutPageLayoutのインスタンスを表すプロパティ。ObjectPropertypageRanges印刷するジョブ・ページをPageRangeの配列として表す値を持つObjectProperty。ObjectProperty<PaperSource>paperSourcePaperSourceのインスタンスを表すプロパティ。ObjectProperty<PrintColor>printColorPrintColorのインスタンスを表すプロパティ。ObjectProperty<PrintQuality>printQualityPrintQualityのインスタンスを表すプロパティ。ObjectProperty<PrintResolution>printResolutionPrintResolutionのインスタンスを表すプロパティ。ObjectProperty<PrintSides>printSidesPrintSidesのインスタンスを表すプロパティ。
 - 
メソッドのサマリーすべてのメソッド インスタンス・メソッド 具象メソッド 修飾子と型 メソッド 説明 ObjectProperty<Collation>collationProperty()Collationのインスタンスを表すプロパティ。IntegerPropertycopiesProperty()ジョブの印刷部数を表すIntegerProperty。CollationgetCollation()Collationは、ドキュメントを複数部印刷する際の用紙のソート方法を決定します。intgetCopies()印刷する部数を取得します。StringgetJobName()ジョブの名前を取得します。PageLayoutgetPageLayout()このジョブの現在のページ・レイアウトを取得します。PageRange[]getPageRanges()印刷するページの範囲。nullは常にすべてのページを意味します。PaperSourcegetPaperSource()プロパティpaperSourceの値を取得します。PrintColorgetPrintColor()プロパティprintColorの値を取得します。PrintQualitygetPrintQuality()プロパティprintQualityの値を取得します。PrintResolutiongetPrintResolution()PrintSidesgetPrintSides()プリンタがサポートしている場合は、ジョブをメディア(紙)の両面に印刷できます(両面印刷)。StringPropertyjobNameProperty()ジョブの名前を表すStringProperty。ObjectProperty<PageLayout>pageLayoutProperty()PageLayoutのインスタンスを表すプロパティ。ObjectPropertypageRangesProperty()印刷するジョブ・ページをPageRangeの配列として表す値を持つObjectProperty。ObjectProperty<PaperSource>paperSourceProperty()PaperSourceのインスタンスを表すプロパティ。ObjectProperty<PrintColor>printColorProperty()PrintColorのインスタンスを表すプロパティ。ObjectProperty<PrintQuality>printQualityProperty()PrintQualityのインスタンスを表すプロパティ。ObjectProperty<PrintResolution>printResolutionProperty()PrintResolutionのインスタンスを表すプロパティ。ObjectProperty<PrintSides>printSidesProperty()PrintSidesのインスタンスを表すプロパティ。voidsetCollation(Collation collation)Collationプロパティを設定します。voidsetCopies(int nCopies)印刷する部数を設定します。voidsetJobName(String name)ジョブの名前を設定します。voidsetPageLayout(PageLayout pageLayout)使用するPageLayoutを設定します。voidsetPageRanges(PageRange... pages)PageRangeの配列として表した、印刷するページの範囲。voidsetPaperSource(PaperSource value)プロパティpaperSourceの値を設定します。voidsetPrintColor(PrintColor color)PrintColorプロパティを設定します。voidsetPrintQuality(PrintQuality quality)PrintQualityプロパティを設定します。voidsetPrintResolution(PrintResolution resolution)PrintResolutionプロパティを設定します。voidsetPrintSides(PrintSides sides)両面印刷を制御するPrintSidesプロパティを設定します。
 
- 
- 
- 
プロパティの詳細- 
jobNamepublic final StringProperty jobNameProperty ジョブの名前を表すStringProperty。- 関連項目:
- getJobName(),- setJobName(String)
 
 - 
copiespublic final IntegerProperty copiesProperty ジョブの印刷部数を表すIntegerProperty。- 関連項目:
- getCopies(),- setCopies(int)
 
 - 
pageRangespublic final ObjectProperty pageRangesProperty 印刷するジョブ・ページをPageRangeの配列として表す値を持つObjectProperty。 null値を指定すると、すべてのページが印刷されます。 それ以外の場合は、ページ番号の昇順に並べられた、PageRangeインスタンスの重複しない配列を指定する必要があります。 ページ番号は1から始まります。 空の配列はnullの配列と同等と見なされます。無効な、または(プリンタで)サポートされないページ範囲のセットは無視されます。 範囲が、印刷時にジョブによってレンダリングされるページ数を超えていても、エラーは発生しません。 
 - 
printSidespublic final ObjectProperty<PrintSides> printSidesProperty PrintSidesのインスタンスを表すプロパティ。
 - 
collationpublic final ObjectProperty<Collation> collationProperty Collationのインスタンスを表すプロパティ。
 - 
printColorpublic final ObjectProperty<PrintColor> printColorProperty PrintColorのインスタンスを表すプロパティ。
 - 
printQualitypublic final ObjectProperty<PrintQuality> printQualityProperty PrintQualityのインスタンスを表すプロパティ。
 - 
printResolutionpublic final ObjectProperty<PrintResolution> printResolutionProperty PrintResolutionのインスタンスを表すプロパティ。
 - 
paperSourcepublic final ObjectProperty<PaperSource> paperSourceProperty PaperSourceのインスタンスを表すプロパティ。
 - 
pageLayoutpublic final ObjectProperty<PageLayout> pageLayoutProperty PageLayoutのインスタンスを表すプロパティ。
 
- 
 - 
メソッドの詳細- 
jobNamePropertypublic final StringProperty jobNameProperty() ジョブの名前を表すStringProperty。- 関連項目:
- getJobName(),- setJobName(String)
 
 - 
getJobNamepublic String getJobName() ジョブの名前を取得します。- 戻り値:
- ジョブの名前を表す文字列
 
 - 
setJobNamepublic void setJobName(String name) ジョブの名前を設定します。- パラメータ:
- name- ジョブの名前を表す文字列
 
 - 
copiesPropertypublic final IntegerProperty copiesProperty() ジョブの印刷部数を表すIntegerProperty。- 関連項目:
- getCopies(),- setCopies(int)
 
 - 
getCopiespublic int getCopies() 印刷する部数を取得します。- 戻り値:
- 印刷部数
 
 - 
setCopiespublic final void setCopies(int nCopies) 印刷する部数を設定します。- パラメータ:
- nCopies- 印刷部数
 
 - 
pageRangesPropertypublic final ObjectProperty pageRangesProperty() 印刷するジョブ・ページをPageRangeの配列として表す値を持つObjectProperty。 null値を指定すると、すべてのページが印刷されます。 それ以外の場合は、ページ番号の昇順に並べられた、PageRangeインスタンスの重複しない配列を指定する必要があります。 ページ番号は1から始まります。 空の配列はnullの配列と同等と見なされます。無効な、または(プリンタで)サポートされないページ範囲のセットは無視されます。 範囲が、印刷時にジョブによってレンダリングされるページ数を超えていても、エラーは発生しません。 
 - 
getPageRangespublic PageRange[] getPageRanges() 印刷するページの範囲。nullは常にすべてのページを意味します。 詳細はpageRangesProperty()を参照してください。- 戻り値:
- nullまたは上で指定した配列
 
 - 
setPageRangespublic void setPageRanges(PageRange... pages) PageRangeの配列として表した、印刷するページの範囲。 可変引数を使用すると、よくある単一範囲のオートボクシングが可能になります。((PageRange[])null)は常にすべてのページを意味しますが、これはデフォルトであるため、あまり使用されません。 詳細はpageRangesProperty()を参照してください。- パラメータ:
- pages- nullまたは上で指定した可変引数配列
 
 - 
printSidesPropertypublic final ObjectProperty<PrintSides> printSidesProperty() PrintSidesのインスタンスを表すプロパティ。
 - 
getPrintSidespublic PrintSides getPrintSides() プリンタがサポートしている場合は、ジョブをメディア(紙)の両面に印刷できます(両面印刷)。 このメソッドは選択された設定を返します。- 戻り値:
- 両面(面)設定。
 
 - 
setPrintSidespublic void setPrintSides(PrintSides sides) 両面印刷を制御するPrintSidesプロパティを設定します。 null値は無視されます。- パラメータ:
- sides- 面数の新しい設定。
 
 - 
collationPropertypublic final ObjectProperty<Collation> collationProperty() Collationのインスタンスを表すプロパティ。
 - 
getCollationpublic Collation getCollation() Collationは、ドキュメントを複数部印刷する際の用紙のソート方法を決定します。 そのため、用紙2枚以上のドキュメントを2部以上印刷する場合にのみ意味を持ちます。 用紙は物理メディアであるため、2ページのドキュメントでも、1ページにまとめて印刷したり、両面印刷したりすると、用紙は1枚のみになります。 丁合いありの印刷ジョブでは、用紙を順番にソートした状態のドキュメントが生成されます。 丁合いなしのジョブでは、同じ用紙が複数枚まとめられます。 uncollated (false)が標準のデフォルト値です。- 戻り値:
- 照合
 
 - 
setCollationpublic void setCollation(Collation collation) Collationプロパティを設定します。 null値は無視されます。- パラメータ:
- collation- 丁合いの新しい設定
 
 - 
printColorPropertypublic final ObjectProperty<PrintColor> printColorProperty() PrintColorのインスタンスを表すプロパティ。
 - 
getPrintColorpublic PrintColor getPrintColor() プロパティprintColorの値を取得します。- プロパティの説明:
- PrintColorのインスタンスを表すプロパティ。
 
 - 
setPrintColorpublic void setPrintColor(PrintColor color) PrintColorプロパティを設定します。 null値は無視されます。- パラメータ:
- color- 印刷色の新しい設定。
 
 - 
printQualityPropertypublic final ObjectProperty<PrintQuality> printQualityProperty() PrintQualityのインスタンスを表すプロパティ。
 - 
getPrintQualitypublic PrintQuality getPrintQuality() プロパティprintQualityの値を取得します。- プロパティの説明:
- PrintQualityのインスタンスを表すプロパティ。
 
 - 
setPrintQualitypublic void setPrintQuality(PrintQuality quality) PrintQualityプロパティを設定します。 null値は無視されます。品質と解像度は重複する概念です。 そのため、プリンタによっては、両方ではなくいずれか一方のみをサポートしている場合もあります。 これらをプログラム的に設定するアプリケーションでは、両方のプロパティを問い合せて、サポートされる値から適宜選択してください。 プリンタが非標準の値をサポートしている場合、それらの値のプリンタによる解釈をコードが判別できない可能性があるため、常に要件に合致する標準値から選択するのが最も安全です。 - パラメータ:
- quality- 印刷品質の新しい設定。
 
 - 
printResolutionPropertypublic final ObjectProperty<PrintResolution> printResolutionProperty() PrintResolutionのインスタンスを表すプロパティ。
 - 
getPrintResolutionpublic PrintResolution getPrintResolution() - 戻り値:
- 印刷解像度
 
 - 
setPrintResolutionpublic void setPrintResolution(PrintResolution resolution) PrintResolutionプロパティを設定します。 null値は無視されます。品質と解像度は重複する概念です。 そのため、プリンタによっては、両方ではなくいずれか一方のみをサポートしている場合もあります。 これらをプログラム的に設定するアプリケーションでは、両方のプロパティを問い合せて、サポートされる値から適宜選択してください。 プリンタが非標準の値をサポートしている場合、それらの値のプリンタによる解釈をコードが判別できない可能性があるため、常に要件に合致する標準値から選択するのが最も安全です。 - パラメータ:
- resolution- 印刷解像度の新しい設定。
 
 - 
paperSourcePropertypublic final ObjectProperty<PaperSource> paperSourceProperty() PaperSourceのインスタンスを表すプロパティ。
 - 
getPaperSourcepublic PaperSource getPaperSource() プロパティpaperSourceの値を取得します。- プロパティの説明:
- PaperSourceのインスタンスを表すプロパティ。
 
 - 
setPaperSourcepublic void setPaperSource(PaperSource value) プロパティpaperSourceの値を設定します。- プロパティの説明:
- PaperSourceのインスタンスを表すプロパティ。
 
 - 
pageLayoutPropertypublic final ObjectProperty<PageLayout> pageLayoutProperty() PageLayoutのインスタンスを表すプロパティ。
 - 
getPageLayoutpublic PageLayout getPageLayout() このジョブの現在のページ・レイアウトを取得します。- 戻り値:
- ジョブに使用するページ・レイアウト。
 
 - 
setPageLayoutpublic void setPageLayout(PageLayout pageLayout) 使用するPageLayoutを設定します。- パラメータ:
- pageLayout- 使用するページ・レイアウト。
 
 
- 
 
-