javafx.scene.layout

Class BackgroundImage

java.lang.Object

javafx.scene.layout.BackgroundImage

public final class BackgroundImage
extends java.lang.Object

Defines properties describing how to render an image as the background to some Region. A BackgroundImage must have an Image specified (it cannot be null). The repeatX and repeatY properties define how the image is to be repeated in each direction. The position property defines how to position the image on the Region while the size property defines the size of the image on the Region. For example, the size might be defined with cover = true, meaning the image should be stretched to cover the entire rendering surface of the Region.

Because the BackgroundImage is immutable, it can safely be used in any cache, and can safely be reused among multiple Regions.

Since:

JavaFX 8.0

Field Summary

Fields

Modifier and Type	Field and Description
private int	hash A cached hash code for faster secondary usage.
(package private) Image	image
(package private) java.lang.Boolean	opaque The Background will cache here whether this BackgroundImage is opaque.
(package private) BackgroundPosition	position
(package private) BackgroundRepeat	repeatX
(package private) BackgroundRepeat	repeatY
(package private) BackgroundSize	size

Constructor Summary

Constructors

Constructor and Description
BackgroundImage(Image image, BackgroundRepeat repeatX, BackgroundRepeat repeatY, BackgroundPosition position, BackgroundSize size) Creates a new BackgroundImage.

Method Summary

Modifier and Type	Method and Description
boolean	equals(java.lang.Object o)
Image	getImage() The image to be used.
BackgroundPosition	getPosition() The position of this BackgroundImage relative to the Region.
BackgroundRepeat	getRepeatX() Indicates in what manner (if at all) the background image is to be repeated along the x-axis of the region.
BackgroundRepeat	getRepeatY() Indicates in what manner (if at all) the background image is to be repeated along the y-axis of the region.
BackgroundSize	getSize() The size of this image relative to the Region.
int	hashCode()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

image

final Image image

repeatX

final BackgroundRepeat repeatX

repeatY

final BackgroundRepeat repeatY

position

final BackgroundPosition position

size

final BackgroundSize size

opaque

java.lang.Boolean opaque

The Background will cache here whether this BackgroundImage is opaque. If this value is null, then it means we don't yet know. If it is non null, then we know for certain it either is, or is not, opaque. Opaque in this case means that the BackgroundImage's image is opaque.

hash

private final int hash

A cached hash code for faster secondary usage. It is expected that BackgroundImage will be pulled from a cache in many cases.

Constructor Detail

BackgroundImage

public BackgroundImage(Image image,
                       BackgroundRepeat repeatX,
                       BackgroundRepeat repeatY,
                       BackgroundPosition position,
                       BackgroundSize size)

Creates a new BackgroundImage. The image must be specified.

Parameters:

image - The image to use. This cannot be null.

repeatX - The BackgroundRepeat for the x axis. If null, this value defaults to REPEAT.

repeatY - The BackgroundRepeat for the y axis. If null, this value defaults to REPEAT.

position - The BackgroundPosition to use. If null, defaults to BackgroundPosition.DEFAULT.

size - The BackgroundSize. If null, defaults to BackgroundSize.DEFAULT.

Method Detail

getImage

public final Image getImage()

The image to be used. This will never be null. If this image fails to load, then the entire BackgroundImage will be skipped at rendering time.

Returns:

the image to be used

getRepeatX

public final BackgroundRepeat getRepeatX()

Indicates in what manner (if at all) the background image is to be repeated along the x-axis of the region. This will never be null.

Returns:

the BackgroundRepeat that indicates if the background image is to be repeated along the x-axis of the region

getRepeatY

public final BackgroundRepeat getRepeatY()

Indicates in what manner (if at all) the background image is to be repeated along the y-axis of the region. This will never be null.

Returns:

the BackgroundRepeat that indicates if the background image is to be repeated along the y-axis of the region

getPosition

public final BackgroundPosition getPosition()

The position of this BackgroundImage relative to the Region. Note that any position outside the background area of the region will be clipped.

Returns:

the position of this BackgroundImage relative to the Region

getSize

public final BackgroundSize getSize()

The size of this image relative to the Region.

Returns:

the size of this image relative to the Region

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object