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

Class BackgroundImage


  • public final class BackgroundImage
extends Object
    定义描述如何将图像呈现为背景的属性Region 。 一个BackgroundImage必须指定一个图像（它不能为null）。 repeatX和repeatY属性定义了如何在每个方向上重复图像。 position属性定义如何在Region上定位图像，而size属性定义了Region上的图像大小。 例如， size可能被定义为cover = true ，这意味着图像应该被拉伸以覆盖整个区域的渲染表面。

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

    从以下版本开始：
    JavaFX 8.0

    • 构造方法详细信息

      • BackgroundImage

        public BackgroundImage​(Image image,
                       BackgroundRepeat repeatX,
                       BackgroundRepeat repeatY,
                       BackgroundPosition position,
                       BackgroundSize size)
        创建一个新的BackgroundImage。 必须指定image 。
        参数
        image - 要使用的图像。 这不能为空。
        repeatX - x轴的BackgroundRepeat。 如果为空，则此值默认为REPEAT。
        repeatY - y轴的BackgroundRepeat。 如果为空，则此值默认为REPEAT。
        position - 要使用的BackgroundPosition。 如果为空，则默认为BackgroundPosition.DEFAULT。
        size - BackgroundSize。 如果为空，则默认为BackgroundSize.DEFAULT。

    • 方法详细信息

      • getImage

        public final Image getImage​()
        要使用的图像。 这将永远不会为空。 如果此图像无法加载，则在渲染时将会跳过整个BackgroundImage。
        结果
        要使用的图像

      • getRepeatX

        public final BackgroundRepeat getRepeatX​()
        以什么方式（如果有的话）表示背景图像将沿着该区域的x轴重复。 这将永远不会为空。
        结果
        BackgroundRepeat指示背景图像是否沿着该区域的x轴重复

      • getRepeatY

        public final BackgroundRepeat getRepeatY​()
        以什么方式（如果有的话）表示背景图像将沿着该区域的y轴重复。 这将永远不会为空。
        结果
        BackgroundRepeat指示背景图像是否沿着该区域的y轴重复

      • getPosition

        public final BackgroundPosition getPosition​()
        这个BackgroundImage相对于Region的位置。 请注意，该区域背景区域之外的任何位置将被剪切。
        结果
        这个BackgroundImage相对于Region的位置

      • getSize

        public final BackgroundSize getSize​()
        该图像相对于Region的大小。
        结果
        该图像相对于Region的大小

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