javafx.scene.layout

Class BackgroundPosition

java.lang.Object

javafx.scene.layout.BackgroundPosition

public class BackgroundPosition
extends Object

Represents the position of a BackgroundImage within the Region's drawing area. The BackgroundImage can be positioned either from the left or right side along the horizontal axis, and from either the top or bottom side along the vertical axis. The horizontalSide and verticalSide properties define to which side the remaining properties pertain. The horizontalPosition specifies the distance of the BackgroundImage from the corresponding side of the Region, and horizontalAsPercentage indicates whether this is as a literal value or a percentage. Similar properties exist for specifying the size relative to the vertical axis. For example, suppose I had a BackgroundPosition with a horizontalSide of Side.RIGHT, a horizontalPosition of .05, and a horizontalAsPercentage of true. In this case, the right side of the BackgroundImage will be 5% of the width of the Region from the Region's right edge.

Since:

JavaFX 8.0

Field Summary

Fields
Modifier and Type	Field and Description
`static BackgroundPosition`	`CENTER` A BackgroundPosition which will center a BackgroundImage.
`static BackgroundPosition`	`DEFAULT` The default BackgroundPosition for any BackgroundImage.

Constructor Summary

Constructors
Constructor and Description
`BackgroundPosition(Side horizontalSide, double horizontalPosition, boolean horizontalAsPercentage, Side verticalSide, double verticalPosition, boolean verticalAsPercentage)` Creates a new BackgroundPosition.

Method Summary

All MethodsInstance MethodsConcrete Methods
Modifier and Type	Method and Description
`boolean`	`equals(Object o)`
`double`	`getHorizontalPosition()` The value indicating the position of the BackgroundImage relative to the Region along the side indicated by the `horizontalSide` property.
`Side`	`getHorizontalSide()` The side along the horizontal axis to which the BackgroundImage is anchored.
`double`	`getVerticalPosition()` The value indicating the position of the BackgroundImage relative to the Region along the side indicated by the `verticalSide` property.
`Side`	`getVerticalSide()` The side along the vertical axis to which the BackgroundImage is anchored.
`int`	`hashCode()`
`boolean`	`isHorizontalAsPercentage()` Specifies whether the `horizontalPosition` should be interpreted as a literal number or as a percentage.
`boolean`	`isVerticalAsPercentage()` Specifies whether the `verticalPosition` should be interpreted as a literal number or as a percentage.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail
- DEFAULT
```
public static final BackgroundPosition DEFAULT
```
  The default BackgroundPosition for any BackgroundImage. The default is to have no insets and to be defined as 0% and 0%. That is, the position is in the top-left corner.
- CENTER
```
public static final BackgroundPosition CENTER
```
  A BackgroundPosition which will center a BackgroundImage.

Constructor Detail

BackgroundPosition

public BackgroundPosition(Side horizontalSide,
                          double horizontalPosition,
                          boolean horizontalAsPercentage,
                          Side verticalSide,
                          double verticalPosition,
                          boolean verticalAsPercentage)

Creates a new BackgroundPosition.

Parameters:

horizontalSide - The horizontal side, must be either null, LEFT, or RIGHT. If null, LEFT will be used. If TOP or BOTTOM is specified, an IllegalArgumentException is thrown.

Method Detail
- getHorizontalSide
```
public final Side getHorizontalSide()
```
  The side along the horizontal axis to which the BackgroundImage is anchored. This will only be LEFT or RIGHT and never null.
- getVerticalSide
```
public final Side getVerticalSide()
```
  The side along the vertical axis to which the BackgroundImage is anchored. This will only be TOP or BOTTOM and never null.
- getHorizontalPosition
```
public final double getHorizontalPosition()
```
  The value indicating the position of the BackgroundImage relative to the Region along the side indicated by the horizontalSide property. This value is either a literal or a percentage, depending on the horizontalAsPercentage property. Negative values are acceptable.
- getVerticalPosition
```
public final double getVerticalPosition()
```
  The value indicating the position of the BackgroundImage relative to the Region along the side indicated by the verticalSide property. This value is either a literal or a percentage, depending on the verticalAsPercentage property. Negative values are acceptable.
- isHorizontalAsPercentage
```
public final boolean isHorizontalAsPercentage()
```
  Specifies whether the horizontalPosition should be interpreted as a literal number or as a percentage.
- isVerticalAsPercentage
```
public final boolean isVerticalAsPercentage()
```
  Specifies whether the verticalPosition should be interpreted as a literal number or as a percentage.
- equals
```
public boolean equals(Object o)
```
  Overrides:
  
  equals in class Object
- hashCode
```
public int hashCode()
```
  Overrides:
  
  hashCode in class Object

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.

Class BackgroundPosition

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

DEFAULT

CENTER

Constructor Detail

BackgroundPosition

Method Detail

getHorizontalSide

getVerticalSide

getHorizontalPosition

getVerticalPosition

isHorizontalAsPercentage

isVerticalAsPercentage

equals

hashCode