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

クラスBackground


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

    すべての背景はfillsまたはimages、あるいはその両方で構成されます。 どちらのリストもnullにはなりませんが、一方または両方を空にできます。 定義された各BackgroundFillは順番にレンダリングされ、その後に、定義された各BackgroundImageが続きます。

    背景のoutsetsは、すべての背景描画に対応するために必要なリージョンの描画領域の拡大を定義します。 すべてのBackgroundImageは描画領域に合せてクリップされ、描画領域を定義しないため、これらのアウトセットは、この背景に指定されているBackgroundFill (存在する場合)によって厳密に定義されます。 アウトセットの値は厳密に負でない数値となります。

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

    • フィールドの詳細

      • EMPTY

        public static final Background EMPTY
        空のBackground。nullのかわりに使用できます。

    • コンストラクタの詳細

      • Background

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

      • Background

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

      • Background

        public Background​(List<BackgroundFill> fills,
                  List<BackgroundImage> images)
        背景の塗りつぶし用と背景のイメージ用の2つのリストを指定して、新しいBackgroundを作成します。 いずれかのリストがnullで、nullが含まれている可能性があります。 これらのリストのnull値はすべて無視され、fills、imagesまたはoutsetsには影響しません。
        パラメータ:
        fills - 塗りつぶし。 これはnullか、nullが含まれている可能性があります。 含まれているnullはすべてフィルタで除外され、塗りつぶしの最終的なリストには含められません。 nullのリストは空のリストになります。
        images - イメージ。 これはnullか、nullが含まれている可能性があります。 含まれているnullはすべてフィルタで除外され、イメージの最終的なリストには含められません。 nullのリストは空のリストになります。

      • Background

        public Background​(BackgroundFill[] fills,
                  BackgroundImage[] images)
        背景の塗りつぶし用と背景のイメージ用の2つの配列を指定して、新しいBackgroundを作成します。 いずれかの配列がnullで、null値が含まれている可能性があります。 これらの配列のnull値はすべて無視され、fills、imagesまたはoutsetsには影響しません。
        パラメータ:
        fills - 塗りつぶし。 これはnullか、nullが含まれている可能性があります。 含まれているnullはすべてフィルタで除外され、塗りつぶしの最終的なリストには含められません。 nullの配列は空のリストになります。
        images - イメージ。 これはnullか、nullが含まれている可能性があります。 含まれているnullはすべてフィルタで除外され、イメージの最終的なリストには含められません。 nullの配列は空のリストになります。

    • メソッドの詳細

      • getClassCssMetaData

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

      • getFills

        public final List<BackgroundFill> getFills​()
        この背景の塗りつぶし部分をともに定義するBackgroundFillのリスト。 このリストは変更不可能で、不変です。 nullにはなりません。 また、このリストの要素はnullにはなりません。
        戻り値:
        BackgroundFillsのリスト

      • getImages

        public final List<BackgroundImage> getImages​()
        この背景のイメージ部分をともに定義するBackgroundImageのリスト。 このリストは変更不可能で、不変です。 nullにはなりません。 また、このリストの要素はnullにはなりません。
        戻り値:
        BackgroundImagesのリスト

      • getOutsets

        public final Insets getOutsets​()
        このBackgroundのアウトセット。 これは、Backgroundのすべての描画が実行される最大境界矩形を表します。 アウトセットは負にならず、リージョンの外端からの距離を表します。 アウトセットを超えて拡張するBackgroundImageはすべてクリップされます。 BackgroundFillのみアウトセットに影響します。
        戻り値:
        アウト・セット

      • isEmpty

        public final boolean isEmpty​()
        背景が空かどうかを取得します。 塗りつぶしまたはイメージがない場合は空になります。
        戻り値:
        背景が空の場合はtrue、そうでない場合はfalse。

      • isFillPercentageBased

        public boolean isFillPercentageBased​()
        この背景の塗りつぶしが割合に基づいているかどうかを取得します(つまり、スタイル設定されるリージョンのサイズに対して相対的であるかどうか)。 特に、この背景のいずれかの塗りつぶしのいずれかのCornerRadiiが割合に基づいた半径である場合、これはtrueを返します。
        戻り値:
        この背景のBackgroundFillのCornerRadiiがtrueを返す場合はtrue、そうでない場合はfalse。
        導入されたバージョン:
        JavaFX 8.0

      • equals

        public boolean equals​(Object o)
        このオブジェクトと他のオブジェクトが等しいかどうかを示します。

        equalsメソッドは、null以外のオブジェクト参照での同値関係を実装します。

        • 反射性(reflexive): null以外の参照値xについて、x.equals(x)はtrueを返します。
        • 対称性(symmetric): null以外の参照値xおよびyについて、y.equals(x)がtrueを返す場合に限り、x.equals(y)はtrueを返します。
        • 推移性(transitive): null以外の参照値x、y、およびzについて、x.equals(y)がtrueを返し、y.equals(z)がtrueを返す場合、x.equals(z)はtrueを返します。
        • 一貫性(consistent): null以外の参照値xおよびyについて、x.equals(y)の複数の呼出しは、このオブジェクトに対するequalsによる比較で使われた情報が変更されていなければ、一貫してtrueを返すか、一貫してfalseを返します。
        • null以外の参照値xについて、x.equals(null)はfalseを返します。

        Objectクラスのequalsメソッドは、もっとも比較しやすいオブジェクトの同値関係を実装します。つまり、null以外の参照値xとyについて、このメソッドはxとyが同じオブジェクトを参照する(x == yがtrue)場合にだけtrueを返します。

        通常、このメソッドをオーバーライドする場合は、hashCodeメソッドを常にオーバーライドして、等価なオブジェクトは等価なハッシュ・コードを保持する必要があるというhashCodeメソッドの汎用規約に従う必要があることに留意してください。

        オーバーライド:
        equals 、クラス:  Object
        パラメータ:
        o - 比較対象の参照オブジェクト。
        戻り値:
        このオブジェクトがobj引数と同じである場合はtrue、それ以外の場合はfalse。
        関連項目:
        Object.hashCode()、HashMap

      • hashCode

        public int hashCode​()
        オブジェクトのハッシュ・コード値を返します。 このメソッドは、HashMapによって提供されるハッシュ表などの、ハッシュ表の利点のためにサポートされています。

        hashCodeの一般的な規則は次のとおりです。

        • Javaアプリケーションの実行中に同じオブジェクトに対して複数回呼び出された場合は常に、このオブジェクトに対するequalsの比較で使用される情報が変更されていなければ、hashCodeメソッドは常に同じ整数を返す必要があります。 ただし、この整数は同じアプリケーションの実行ごとに同じである必要はありません。
        • equals(Object)メソッドに従って2つのオブジェクトが等しい場合は、2つの各オブジェクトに対するhashCodeメソッドの呼出しによって同じ整数の結果が生成される必要があります。
        • Object.equals(java.lang.Object)メソッドに従って2つのオブジェクトが等しくない場合は、2つの各オブジェクトに対するhashCodeメソッドの呼出しによって異なる整数の結果が生成される必要はありません。 ただし、プログラマは、等しくないオブジェクトに対して異なる整数の結果を生成すると、ハッシュ表のパフォーマンスが向上する可能性があることに注意するようにしてください。

        クラスObjectによって定義されたhashCodeメソッドは、可能なかぎり、異なるオブジェクトに対して異なる整数を返します。 (hashCodeは、ある時点におけるオブジェクト・メモリー・アドレスの関数として実装されても実装されなくてもよい。)

        オーバーライド:
        hashCode 、クラス:  Object
        戻り値:
        このオブジェクトのハッシュ・コード値。
        関連項目:
        Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)