Module  javafx.graphics
软件包  javafx.scene.layout

Class BackgroundPosition


  • public class BackgroundPosition
extends Object
    表示的位置BackgroundImage的内Region的绘图区域。

    BackgroundImage可以沿着水平轴线从左侧或右侧定位，也可以沿垂直轴线从顶侧或底侧定位。 horizontalSide和verticalSide属性定义了其余属性与哪一方有关。 horizontalPosition指定了BackgroundImage与Region对应的一边的距离，而horizontalAsPercentage则指定是否为文字值或百分比。 存在用于指定相对于垂直轴的大小的类似属性。

    例如，假设我有一个背景位置，其中horizontalSide是Side.RIGHT为horizontalPosition和horizontalAsPercentage的true 。 在这种情况下，BackgroundImage的右侧将是Region区域右边缘宽度的5％。

    从以下版本开始：
    JavaFX 8.0

    • 字段详细信息

      • DEFAULT

        public static final BackgroundPosition DEFAULT
        任何BackgroundImage的默认BackgroundPosition。 默认值为没有插入，并被定义为0％和0％。 也就是说，位置在左上角。

      • CENTER

        public static final BackgroundPosition CENTER
        一个将背景图像中心的BackgroundPosition。

    • 构造方法详细信息

      • BackgroundPosition

        public BackgroundPosition​(Side horizontalSide,
                          double horizontalPosition,
                          boolean horizontalAsPercentage,
                          Side verticalSide,
                          double verticalPosition,
                          boolean verticalAsPercentage)
        创建一个新的BackgroundPosition。
        参数
        horizontalSide - 水平面必须为null，LEFT或RIGHT。 如果为空，则使用LEFT。 如果指定了TOP或BOTTOM，则抛出IllegalArgumentException。
        horizontalPosition - 水平位置值。
        horizontalAsPercentage - 是否将水平位置解读为小数或百分比
        verticalSide - 垂直面必须为null，TOP或BOTTOM。 如果为空，则将使用TOP。 如果指定了LEFT或RIGHT，则抛出IllegalArgumentException。
        verticalPosition - 垂直位置值。
        verticalAsPercentage - 是否将垂直位置解释为十进制或百分比

    • 方法详细信息

      • getHorizontalSide

        public final Side getHorizontalSide​()
        背景图像被锚定在水平轴的一侧。 这只会是LEFT或RIGHT，从不为null。
        结果
        沿着ImageImage所锚定的水平轴的Side

      • getVerticalSide

        public final Side getVerticalSide​()
        沿着垂直轴的SideMap背景。 这只会是TOP或BOTTOM，永远不会为空。
        结果
        沿着垂直轴的Side，SideMap被锚定到

      • getHorizontalPosition

        public final double getHorizontalPosition​()
        表示BackgroundImage相对于由horizontalSide属性指示的一侧的区域的位置的值。 此值为字面值或百分比，具体取决于horizontalAsPercentage属性。 负值是可以接受的。
        结果
        BackgroundImage的水平位置

      • getVerticalPosition

        public final double getVerticalPosition​()
        表示BackgroundImage相对于由verticalSide属性指示的一侧的区域的位置的值。 该值是文字或百分比，具体取决于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方法在非空对象引用上实现等价关系：

        • 自反性 ：对于任何非空的参考值x ， x.equals(x)应该返回true 。
        • 它是对称的 ：对于任何非空引用值x和y ， x.equals(y)应该返回true当且仅当y.equals(x)回报true 。
        • 传递性 ：对于任何非空引用值x ， y ，并z ，如果x.equals(y)回报true和y.equals(z)回报true ，然后x.equals(z)应该返回true 。
        • 它是一致的 ：对于任何非空引用值x和y ，在多次调用x.equals(y)始终返回true或始终返回false ，没有设置中使用的信息equals比较上的对象被修改。
        • 对于任何非空的参考值x ， x.equals(null)应该返回false 。

        该equals类方法Object实现对象上差别可能性最大的相等关系; 也就是说，对于任何非空参考值x和y ，当且仅当x和y引用相同对象（ x == y具有值true ）时，该方法返回true 。

        请注意，无论何时覆盖此方法，通常需要覆盖hashCode方法，以便维护hashCode方法的一般合同，该方法规定相等的对象必须具有相等的哈希码。

        重写：
        equals在 Object
        参数
        o - 与之比较的参考对象。
        结果
        true如果该对象与obj参数相同; 否则为false 。
        另请参见：
        Object.hashCode() ， HashMap

      • hashCode

        public int hashCode​()
        返回对象的哈希码值。 支持这种方法是为了哈希表的利益，如HashMap提供的那样 。

        hashCode的总合同是：

        • 无论何时在执行Java应用程序时多次在同一个对象上调用该方法， hashCode方法必须始终返回相同的整数，前提是修改了equals对象中的信息。 该整数不需要从一个应用程序的执行到相同应用程序的另一个执行保持一致。
        • 如果两个对象根据equals(Object)方法相等，则在两个对象中的每个对象上调用hashCode方法必须产生相同的整数结果。
        • 不要求如果两个对象根据Object.equals(java.lang.Object)方法不相等，那么在这两个对象中的每个对象上调用hashCode方法必须产生不同的整数结果。 但是，程序员应该意识到，为不等对象生成不同的整数结果可能会提高哈希表的性能。

        尽可能合理实用，由类Object定义的hashCode方法确实为不同对象返回不同的整数。 （在某个时间点，hashCode可能或可能不被实现为对象的存储器地址的某些功能。）

        重写：
        hashCode在 Object
        结果
        该对象的哈希码值。
        另请参见：
        Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)