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

Class BorderWidths


  • public final class BorderWidths
extends Object
    定义四个组件（顶部，右侧，底部和左侧）的宽度。 每个宽度被定义为非负值。 此值可能取决于为值被解释或者作为文字值，或作为区域的宽度或高度的百分比， topAsPercentage ， rightAsPercentage ， bottomAsPercentage ， leftAsPercentage 。 顶部，右侧，底部和左侧唯一允许的负值为AUTO 。

    因为BorderWidths是不可变的，所以它可以安全地用在任何缓存中，并且可以安全地在多个区域之间重用。

    从以下版本开始：
    JavaFX 8.0

    • Field Summary

      Fields  
      Modifier and Type Field 描述
      static double AUTO
      当BorderStroke使用时，AUTO的值被解释为对应的 BorderStroke.MEDIUM的值。
      static BorderWidths DEFAULT
      指定null时由BorderImage使用的默认BorderWidth。
      static BorderWidths EMPTY
      一组空的宽度，使得所有值都为0，并且是文字值。
      static BorderWidths FULL
      一组宽度，表示每边100％。

    • 构造方法摘要

      构造方法  
      Constructor 描述
      BorderWidths​(double width)
      使用所有四个边框的给定宽度创建一个新的BorderWidth，并将此宽度视为文字值，而不是百分比。
      BorderWidths​(double top, double right, double bottom, double left)
      创建一个新的BorderWidths，具有指定的顶部，右侧，底部和左侧的宽度。
      BorderWidths​(double top, double right, double bottom, double left, boolean topAsPercentage, boolean rightAsPercentage, boolean bottomAsPercentage, boolean leftAsPercentage)
      创建一个新的BorderWidths。

    • 字段详细信息

      • AUTO

        public static final double AUTO
        当BorderStroke使用时，AUTO的值被解释为对应的BorderStroke.MEDIUM的值。 当与BorderImage一起使用时，AUTO的值意味着从BorderStroke读取相应的值，而不是手动指定。
        另请参见：
        Constant Field Values

      • DEFAULT

        public static final BorderWidths DEFAULT
        指定null时由BorderImage使用的默认BorderWidth。 此宽度是单个1像素顶部，右侧，底部和左侧，全部解释为文字值。

      • EMPTY

        public static final BorderWidths EMPTY
        一组空的宽度，使得所有值都为0，并且是文字值。

      • FULL

        public static final BorderWidths FULL
        一组宽度，表示每边100％。

    • 构造方法详细信息

      • BorderWidths

        public BorderWidths​(double width)
        使用所有四个边框的给定宽度创建一个新的BorderWidth，并将此宽度视为文字值，而不是百分比。
        参数
        width - 边框宽度。 这不能是负面的。

      • BorderWidths

        public BorderWidths​(double top,
                    double right,
                    double bottom,
                    double left)
        创建一个新的BorderWidths，具有指定的顶部，右侧，底部和左侧的宽度。 这些值都不是负数。 这些值中的每一个都被解释为文字值，而不是百分比。
        参数
        top - 顶部边框的厚度。 必须是非负数。
        right - 右边边框的厚度。 必须是非负数。
        bottom - 底部边框的厚度。 必须是非负数。
        left - 左边边框的厚度。 必须是非负数。

      • BorderWidths

        public BorderWidths​(double top,
                    double right,
                    double bottom,
                    double left,
                    boolean topAsPercentage,
                    boolean rightAsPercentage,
                    boolean bottomAsPercentage,
                    boolean leftAsPercentage)
        创建一个新的BorderWidths。 的值的无为top ， right ， bottom ，或left可以是非负的。
        参数
        top - 顶部边框的厚度。 必须是非负数。
        right - 右边边框的厚度。 必须是非负数。
        bottom - 底部边框的厚度。 必须是非负数。
        left - 左边边框的厚度。 必须是非负数。
        topAsPercentage - 顶部是否应被视为百分比。
        rightAsPercentage - 是否将权利视为百分比。
        bottomAsPercentage - 底部是否应被视为百分比。
        leftAsPercentage - 左边是否应该被视为百分比。

    • 方法详细信息

      • getTop

        public final double getTop​()
        非负值（ AUTO除外 ），表示边框顶部的边框厚度。 该值可以是字面值，也可以根据topAsPercentage属性的值作为百分比对待。
        结果
        边框顶部的边框厚度

      • getRight

        public final double getRight​()
        非负值（ AUTO除外 ），表示边框右侧的边框厚度。 该值可以是字面值，也可以根据rightAsPercentage属性的值作为百分比对待。
        结果
        边界边界厚度在边界的右边

      • getBottom

        public final double getBottom​()
        非负值（ AUTO除外 ），表示边框底部的边框厚度。 该值可以是字面值，也可以根据bottomAsPercentage属性的值作为百分比对待。
        结果
        边框底部的边框厚度

      • getLeft

        public final double getLeft​()
        非负值（ AUTO除外 ），表示边框左侧的边框厚度。 该值可以是字面值，也可以根据leftAsPercentage属性的值作为百分比对待。
        结果
        边界左边的厚度

      • isTopAsPercentage

        public final boolean isTopAsPercentage​()
        指定 top属性是否应解释为区域高度的百分比（ true ）（ false ）。
        结果
        如果top应该被解释为区域高度的百分比，则为true，否则为false

      • isRightAsPercentage

        public final boolean isRightAsPercentage​()
        指定 right属性是否应解释为区域宽度的百分比（ true ）（ false ）。
        结果
        如果正确的话应该被解释为区域宽度的百分比，否则为false

      • isBottomAsPercentage

        public final boolean isBottomAsPercentage​()
        指定 bottom属性是否应解释为区域高度的百分比（ true ）（ false ）。
        结果
        如果底部应解释为区域高度的百分比，则为true，否则为false

      • isLeftAsPercentage

        public final boolean isLeftAsPercentage​()
        指定 left属性是否应解释为区域宽度的百分比（ true ）（ false ）。
        结果
        如果剩下的话应该被解释为区域宽度的百分比，否则为false

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