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

クラスBackgroundPosition


  • public class BackgroundPosition
extends Object
    Regionの描画領域内のBackgroundImageの位置を表します。

    BackgroundImageは、水平軸に沿って左と右のいずれかから、および垂直軸に沿って上と下のいずれかから配置できます。 horizontalSideおよびverticalSideプロパティは、残りのプロパティがどの辺に関係するかを定義します。 horizontalPositionはリージョンの対応する辺からBackgroundImageまでの距離を指定し、horizontalAsPercentageはこれがリテラル値と割合のどちらであるかを示します。 垂直軸に対して相対的なサイズを指定する同様のプロパティがあります。

    たとえば、horizontalSideがSide.RIGHT、horizontalPositionが.05、horizontalAsPercentageがtrueのBackgroundPositionがあるとします。 この場合、BackgroundImageの右側は、リージョンの右端からリージョンの幅の5%となります。

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

    • フィールドの詳細

      • DEFAULT

        public static final BackgroundPosition DEFAULT
        すべてのBackgroundImageのデフォルトのBackgroundPosition。 デフォルトでは枠がなく、0%として定義され、0%です。 つまり、位置は左上隅にあります。

      • CENTER

        public static final BackgroundPosition CENTER
        BackgroundImageを中央揃えするBackgroundPosition。

    • コンストラクタの詳細

      • BackgroundPosition

        public BackgroundPosition​(Side horizontalSide,
                          double horizontalPosition,
                          boolean horizontalAsPercentage,
                          Side verticalSide,
                          double verticalPosition,
                          boolean verticalAsPercentage)
        新しいBackgroundPositionを作成します。
        パラメータ:
        horizontalSide - 水平方向で、null、LEFTまたはRIGHTのいずれかである必要があります。 nullの場合、LEFTが使用されます。 TOPまたはBOTTOMが指定されている場合は、IllegalArgumentExceptionがスローされます。
        horizontalPosition - 水平位置の値。
        horizontalAsPercentage - 水平位置を10進数と割合のどちらとして解釈するか。
        verticalSide - 垂直方向で、null、TOPまたはBOTTOMのいずれかである必要があります。 nullの場合、TOPが使用されます。 LEFTまたはRIGHTが指定されている場合は、IllegalArgumentExceptionがスローされます。
        verticalPosition - 垂直位置の値。
        verticalAsPercentage - 垂直位置を10進数と割合のどちらとして解釈するか。

    • メソッドの詳細

      • getHorizontalSide

        public final Side getHorizontalSide​()
        BackgroundImageがアンカーされる、水平軸に沿った側。 これは、LEFTまたはRIGHTのみでnullにはなりません。
        戻り値:
        BackgroundImageが固定されている水平軸に沿ったサイド

      • getVerticalSide

        public final Side getVerticalSide​()
        BackgroundImageがアンカーされる、垂直軸に沿った側。 これは、TOPまたはBOTTOMのみでnullにはなりません。
        戻り値:
        BackgroundImageが固定されている垂直軸に沿った側面

      • getHorizontalPosition

        public final double getHorizontalPosition​()
        horizontalSideプロパティによって指定された方向に沿って、リージョンに対して相対的なBackgroundImageの位置を示す値。 この値はhorizontalAsPercentageプロパティに応じて、リテラルまたは割合のいずれかになります。 負の値は許容されます。
        戻り値:
        BackgroundImageの水平位置

      • getVerticalPosition

        public final double getVerticalPosition​()
        verticalSideプロパティによって指定された方向に沿って、リージョンに対して相対的なBackgroundImageの位置を示す値。 この値はverticalAsPercentageプロパティに応じて、リテラルまたは割合のいずれかになります。 負の値は許容されます。
        戻り値:
        BackgroundImageの垂直位置

      • isHorizontalAsPercentage

        public final boolean isHorizontalAsPercentage​()
        horizontalPositionをリテラル数値と割合のどちらとして解釈するかを指定します。
        戻り値:
        horizontalPositionをパーセンテージとして解釈する必要がある場合はtrue

      • isVerticalAsPercentage

        public final boolean isVerticalAsPercentage​()
        verticalPositionをリテラル数値と割合のどちらとして解釈するかを指定します。
        戻り値:
        verticalPositionをパーセンテージとして解釈する必要がある場合はtrue

      • 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)