モジュール javafx.graphics
パッケージ javafx.scene.layout

クラスBorder

  • public final class Border
extends Object
    Regionのボーダー。 ボーダーは、リージョンのボーダーのレンダリングに必要な一連のデータ全体をカプセル化する不変のオブジェクトです。 このクラスは不変のため、複数の異なるリージョンで同じボーダーを自由に再使用できます。 リージョンのボーダーをスタイリングするCSSルールの詳細については、「JavaFX CSSリファレンス・ガイド」を参照してください。

    すべてのボーダーはstrokesまたはimages、あるいはその両方で構成されます。 どちらのリストもnullにはなりませんが、一方または両方を空にできます。 レンダリング時に、イメージが指定されていないまたはイメージのロードに失敗した場合は、すべてのストロークが順番にレンダリングされます。 イメージが指定され、ロードに成功した場合は、ストロークは描画されませんが、ボーダーのinsetsおよびoutsetsには影響します。

    ボーダーのoutsetsは、すべてのボーダーの描画および配置に対応するために必要なリージョンの描画領域の拡大を定義します。 これらのアウトセットは、このボーダーに指定されているBorderStrokeとBorderImageの両方で定義されます。 アウトセットは厳密に負でない数値となります。

    getInsets()は、すべてのボーダーの最も内側の端の定義に使用されます。 また、常に厳密に負でない数値となります。 リージョンは、Backgroundおよびボーダーの枠、およびRegion's paddingを使用して、リージョンのinsetsを決定し、リージョンの子のコンテンツ領域を定義します。 ボーダーのアウトセット、背景のアウトセット、およびリージョンの幅と高さによって、リージョンの幾何学的境界が定義されます(layoutBounds、boundsInLocalおよびboundsInParentに順に影響します)。

    ボーダーは、イメージを持つリージョンをスキップする場合に最もよく使用され、多くの場合、9パッチ・スケーリング手法とともに使用されます。 そのような場合、ストロークされるボーダーを指定することもできますが、これは、なんらかの理由でイメージのロードに失敗した場合にのみ使用されます。

    導入されたバージョン:
    JavaFX 8.0

    • フィールドの詳細

      • EMPTY

        public static final Border EMPTY
        空のボーダーで、nullのかわりに使用するのに役立ちます。

    • コンストラクタの詳細

      • Border

        public Border​(BorderStroke... strokes)
        BorderStrokesの配列を指定して、新しいBorderを作成します。 この配列はnullか、null値が含まれている可能性があります。 null値はすべて無視され、strokesまたはoutsetsまたはinsetsには影響しません。
        パラメータ:
        strokes - ストローク。 これはnullか、nullが含まれている可能性があります。 含まれているnullはすべてフィルタで除外され、ストロークの最終的なリストには含められません。 nullの配列は空のリストになります。 ストロークおよびイメージの両方が指定され、指定されたイメージのいずれかのロードに成功した場合は、ストロークは表示されません。 このように、イメージのロードに失敗した場合は、フォールバックとしてストロークを定義できます。

      • Border

        public Border​(BorderImage... images)
        BorderImagesの配列を指定して、新しいBorderを作成します。 この配列はnullか、null値が含まれている可能性があります。 null値はすべて無視され、imagesまたはoutsetsまたはinsetsには影響しません。
        パラメータ:
        images - イメージ。 これはnullか、nullが含まれている可能性があります。 含まれているnullはすべてフィルタで除外され、イメージの最終的なリストには含められません。 nullの配列は空のリストになります。

      • Border

        public Border​(List<BorderStroke> strokes,
              List<BorderImage> images)
        BorderStrokesおよびBorderImagesのリストを指定して、新しいBorderを作成します。 これらのリストはnullか、null値が含まれている可能性があります。 null値はすべて無視され、strokesまたはimages、outsetsまたはinsetsには影響しません。
        パラメータ:
        strokes - ストローク。 これはnullか、nullが含まれている可能性があります。 含まれているnullはすべてフィルタで除外され、ストロークの最終的なリストには含められません。 nullの配列は空のリストになります。 ストロークおよびイメージの両方が指定され、指定されたイメージのいずれかのロードに成功した場合は、ストロークは表示されません。 このように、イメージのロードに失敗した場合は、フォールバックとしてストロークを定義できます。
        images - イメージ。 これはnullか、nullが含まれている可能性があります。 含まれているnullはすべてフィルタで除外され、イメージの最終的なリストには含められません。 nullの配列は空のリストになります。

      • Border

        public Border​(BorderStroke[] strokes,
              BorderImage[] images)
        BorderStrokesとBorderImagesの配列を指定して、新しいBorderを作成します。 これらの配列はnullか、null値が含まれている可能性があります。 null値はすべて無視され、strokesまたはimages、outsetsまたはinsetsには影響しません。
        パラメータ:
        strokes - ストローク。 これはnullか、nullが含まれている可能性があります。 含まれているnullはすべてフィルタで除外され、ストロークの最終的なリストには含められません。 nullの配列は空のリストになります。 ストロークおよびイメージの両方が指定され、指定されたイメージのいずれかのロードに成功した場合は、ストロークは表示されません。 このように、イメージのロードに失敗した場合は、フォールバックとしてストロークを定義できます。
        images - イメージ。 これはnullか、nullが含まれている可能性があります。 含まれているnullはすべてフィルタで除外され、イメージの最終的なリストには含められません。 nullの配列は空のリストになります。

    • メソッドの詳細

      • getClassCssMetaData

        public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()
        戻り値:
        このクラスに関連付けられたCssMetaData。スーパークラスのCssMetaDataを含むことがあります。

      • getStrokes

        public final List<BorderStroke> getStrokes()
        このボーダーのストロークされる部分をともに定義するBorderStrokeのリスト。 このリストは変更不可能で、不変です。 nullにはなりません。 null要素は含まれません。
        戻り値:
        このBorderのストローク部分を一緒に定義するBorderStrokesのリスト

      • getImages

        public final List<BorderImage> getImages()
        このボーダーのストロークのかわりに使用するイメージをともに定義するBorderImageのリスト。 このリストが指定され、リスト内の1つ以上のイメージのロードに成功した場合は、指定されたstrokesは描画されません。 このリストがnull、またはイメージのロードに失敗した場合は、指定されたstrokesが描画されます。

        このリストは変更不可能で、不変です。 nullにはなりません。 null要素は含まれません。

        戻り値:
        このBorderのストロークの代わりに使用するイメージを定義するBorderImagesのリスト

      • getOutsets

        public final Insets getOutsets()
        枠線のアウトセットは、描画される枠線の最も外側の端を定義します。 これらのアウトセットの値は厳密に負でない数値となります。
        戻り値:
        境界のアウト・セットは、描画されるボーダーの最も外側のエッジを定義

      • getInsets

        public final Insets getInsets()
        枠は、リージョンの端から枠線の最も内側の端までの距離を定義します(その距離が負でない場合)。 これらのアウトセットの値は厳密に負でない数値となります。
        戻り値:
        インセットは、リージョンの端からボーダーの最も内側の端までの距離を定義

      • isEmpty

        public final boolean isEmpty()
        ボーダーが空かどうかを取得します。 ストロークまたはイメージがない場合は空になります。
        戻り値:
        ボーダーが空の場合はtrue、そうでない場合はfalse。