モジュール javafx.graphics
パッケージ javafx.print

クラスPageLayout


  • public final class PageLayout
    extends Object
    PageLayoutは、コンテンツのレイアウトに必要な情報をカプセル化します。 レポートされる幅と高さは、ウィンドウによって施行されるクリップと同等と見なすことができます。 PageLayoutインスタンスを取得するアプリケーションでは、レイアウトおよびページ区切りを実行するために幅と高さを検査する必要があります。 その他の情報(向きや使用する用紙、この領域の外側のマージンなど)は、ページのレンダリングには必要ありません。

    通常、プリンタには印刷不可能なハードウェア・マージンがあります。 特定のプリンタに関してプリンタ・ジョブから取得したPageLayoutインスタンスは、その領域全体に印刷できるよう正しく設定されています。 アプリケーションでこの境界の外側の印刷可能領域を調整すると、その領域へのレンダリング内容はデバイスによってクリップされます。

    そのようなハードウェア・マージン内で、アプリケーションが必要とする印刷可能領域を定義できます。 その結果の印刷可能領域は、印刷時にアプリケーションで使用可能なページの有効寸法を定義したものとなります。

    あるプリンタに基づいて構成されたPageLayoutを別のプリンタ上のジョブに適用しようとしてもうまくいかないことがありますが、これは、2番目のプリンタが同じマージンをサポートしていない、または同じ用紙をサポートしていないためです。 その場合は、PageLayoutを新しいプリンタに対して検証する必要があります。

    PageLayoutは不変です。

    導入されたバージョン:
    JavaFX 8.0
    • メソッドの詳細

      • getPaper

        public Paper getPaper()
        使用される用紙。
        戻り値:
        このPageLayoutに使用される用紙。
      • getPrintableWidth

        public double getPrintableWidth()
        向きを考慮した、ページの印刷可能領域の幅寸法(1/72インチのポイント単位)を返します。

        印刷可能領域とは、リクエストされた両側のマージンを差し引いた幅または高さです。 リクエストされたマージンがハードウェア・マージンより小さい場合は、レンダリング内容がデバイスによってクリップされる可能性があります。

        返される値は向きを考慮したものです。したがって、向きがLANDSCAPEまたはREVERSE_LANDSCAPEの場合は90度回転しているため、基礎となる用紙の高さから左マージンと右マージンが差し引かれます。

        戻り値:
        印刷可能な幅(ポイント単位)。
      • getPrintableHeight

        public double getPrintableHeight()
        向きを考慮した、ページの印刷可能領域の高さ寸法(1/72インチ単位)を返します。

        印刷可能領域とは、リクエストされた両側のマージンを差し引いた幅または高さです。 リクエストされたマージンがハードウェア・マージンより小さい場合は、レンダリング内容がデバイスによってクリップされる可能性があります。

        返される値は向きを考慮したものです。したがって、向きがLANDSCAPEまたはREVERSE_LANDSCAPEの場合は90度回転しているため、基礎となる用紙の高さから上マージンと下マージンが差し引かれます。

        戻り値:
        印刷可能な高さ(ポイント単位)。
      • getLeftMargin

        public double getLeftMargin()
        ページ・レイアウトの左マージン(ポイント単位)を返します。 これはPageLayoutの向きでの値です。
        戻り値:
        左マージン(ポイント単位)。
      • getRightMargin

        public double getRightMargin()
        ページ・レイアウトの右マージン(ポイント単位)を返します。 これはPageLayoutの向きでの値です。
        戻り値:
        右マージン(ポイント単位)。
      • getTopMargin

        public double getTopMargin()
        ページ・レイアウトの上マージン(ポイント単位)を返します。 これはPageLayoutの向きでの値です。
        戻り値:
        上マージン(ポイント単位)。
      • getBottomMargin

        public double getBottomMargin()
        ページ・レイアウトの下マージン(ポイント単位)を返します。 これはPageLayoutの向きでの値です。
        戻り値:
        下マージン(ポイント単位)。