Класс BackgroundImage

java.lang.Object

javafx.scene.layout.BackgroundImage

Все реализуемые интерфейсы:: Interpolatable<BackgroundImage>

public final class BackgroundImage extends Object implements Interpolatable<BackgroundImage>

Определяет свойства, описывающие, как отобразить изображение в качестве фона для некоторого Region. BackgroundImage должен содержать указанное изображение (не может быть null). Свойства repeatX и repeatY определяют, как изображение должно повторяться в каждом направлении. Свойство position определяет, как позиционировать изображение на области, а свойство size — размер изображения на области. Например, size может быть определено с помощью cover = true, что означает, что изображение должно быть растянуто, чтобы покрыть всю область отрисовки области.

Поскольку BackgroundImage является неизменяемым, его можно безопасно использовать в любом кэше и повторно использовать для нескольких областей.

С:: JavaFX 8.0

Краткое описание конструкторов

Конструктор	Описание
`BackgroundImage(Image image, BackgroundRepeat repeatX, BackgroundRepeat repeatY, BackgroundPosition position, BackgroundSize size)`	Создаёт новый BackgroundImage.

Краткое описание методов

Модификатор и тип	Метод	Описание
`final Image`	`getImage()`	Используемое изображение.
`final BackgroundPosition`	`getPosition()`	Положение этого BackgroundImage относительно области.
`final BackgroundRepeat`	`getRepeatX()`	Указывает, как (если вообще) изображение фона должно повторяться по оси X области.
`final BackgroundRepeat`	`getRepeatY()`	Указывает, как (если вообще) изображение фона должно повторяться по оси Y области.
`final BackgroundSize`	`getSize()`	Размер этого изображения относительно области.
`BackgroundImage`	`interpolate(BackgroundImage endValue, double t)`	Возвращает промежуточное значение между значением этого `Interpolatable` и указанным `endValue` с использованием линейного коэффициента интерполяции `t`, значения которого лежат в диапазоне от 0 (включительно) до 1 (включительно).

Методы, объявленные в классе java.lang.Object

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

Подробное описание конструкторов

BackgroundImage

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

Создаёт новый BackgroundImage. Необходимо указать image.

Параметры:: image - Используемое изображение. Не может быть null.; repeatX - BackgroundRepeat для оси X. Если null, по умолчанию используется REPEAT.; repeatY - BackgroundRepeat для оси Y. Если null, по умолчанию используется REPEAT.; position - Используемое BackgroundPosition. Если null, по умолчанию используется BackgroundPosition.DEFAULT.; size - BackgroundSize. Если null, по умолчанию используется BackgroundSize.DEFAULT.

Подробное описание методов

getImage

public final Image getImage()

Используемое изображение. Никогда не будет null. Если загрузка изображения завершится ошибкой, весь BackgroundImage будет пропущен при отрисовке.

Тип интерполяции:: discrete
Возвращает:: используемое изображение

getRepeatX

public final BackgroundRepeat getRepeatX()

Указывает, как (если вообще) изображение фона должно повторяться по оси X области. Никогда не будет null.

Тип интерполяции:: discrete
Возвращает:: BackgroundRepeat, указывающий, нужно ли повторять изображение фона по оси X области

getRepeatY

public final BackgroundRepeat getRepeatY()

Указывает, как (если вообще) изображение фона должно повторяться по оси Y области. Никогда не будет null.

Тип интерполяции:: discrete
Возвращает:: BackgroundRepeat, указывающий, нужно ли повторять изображение фона по оси Y области

getPosition

public final BackgroundPosition getPosition()

Положение этого BackgroundImage относительно области. Обратите внимание, что любая позиция за пределами области фона области будет обрезана.

Тип интерполяции:: default
Возвращает:: положение этого BackgroundImage относительно области

getSize

public final BackgroundSize getSize()

Размер этого изображения относительно области.

Тип интерполяции:: default
Возвращает:: размер этого изображения относительно области

interpolate

public BackgroundImage interpolate(BackgroundImage endValue, double t)

Возвращает промежуточное значение между значением этого Interpolatable и указанным endValue с использованием линейного коэффициента интерполяции t, значения которого лежат в диапазоне от 0 (включительно) до 1 (включительно).

Возвращаемое значение может не быть новым экземпляром; реализация также может вернуть один из двух существующих экземпляров, если промежуточное значение будет равно одному из существующих значений. Однако это оптимизация, и приложения не должны предполагать какой-либо конкретной идентичности возвращаемого значения.

Определено в:: interpolate в интерфейсе Interpolatable<BackgroundImage>
Параметры:: endValue - целевое значение; t - коэффициент интерполяции
Возвращает:: промежуточное значение
Исключения:: NullPointerException - если endValue является null
С:: 24

© 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.