Класс Background

java.lang.Object

javafx.scene.layout.Background

Все реализованные интерфейсы:: Interpolatable<Background>

public final class Background extends Object implements Interpolatable<Background>

Фоновое изображение Region. Фон — это неизменяемый объект, который encapsulates весь набор данных, необходимых для отображения фона области. Поскольку этот класс неизменяемый, вы можете свободно повторно использовать один и тот же фон для многих различных областей. Обратитесь к Руководству по справочнику CSS JavaFX для получения полного описания правил CSS для стилизации фона области.

Каждый фон состоит из fills и/или images. Ни один из списков не будет null, но один или оба могут быть пустыми. Каждый определенный BackgroundFill рендерится в порядке, за которым следуют каждый определенный BackgroundImage.

outsets фона определяют любое расширение области рисования области, необходимое для учета всего рисования фона. Эти отступы строго определяются BackgroundFills, указанными в этом фоне, если таковые имеются, потому что все BackgroundImages обрезаются до области рисования и не определяют её. Значения отступов строго неотрицательны.

С:: JavaFX 8.0

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final Background`	`EMPTY`	Пустой фон, полезный для использования вместо null.

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

Конструктор	Описание
`Background(List<BackgroundFill> fills, List<BackgroundImage> images)`	Создайте новый фон, предоставив два списка: один для заполнения фона, а другой — для изображений фона.
`Background(BackgroundFill... fills)`	Создайте новый фон, предоставив массив BackgroundFills.
`Background(BackgroundFill[] fills, BackgroundImage[] images)`	Создайте новый фон, предоставив два массива: один для заполнения фона, а другой — для изображений фона.
`Background(BackgroundImage... images)`	Создайте новый фон, предоставив массив BackgroundImages.

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

Модификатор и тип	Метод	Описание
`static Background`	`fill(Paint fill)`	Удобный фабричный метод для создания `Background` с одним `Paint`.
`static List<CssMetaData<? extends Styleable,?>>`	`getClassCssMetaData()`	Получает `CssMetaData`, связанный с этим классом, который может включать `CssMetaData` его суперклассов.
`final List<BackgroundFill>`	`getFills()`	Список BackgroundFills, которые вместе определяют заполненную часть этого фона.
`final List<BackgroundImage>`	`getImages()`	Список BackgroundImages, которые вместе определяют часть изображения этого фона.
`final Insets`	`getOutsets()`	Отступы этого фона.
`Background`	`interpolate(Background endValue, double t)`	Возвращает промежуточное значение между значением этого `Interpolatable` и указанным `endValue` с использованием линейного интерполяционного коэффициента `t`, изменяющегося от 0 (включительно) до 1 (включительно).
`final boolean`	`isEmpty()`	Определяет, является ли фон пустым.
`boolean`	`isFillPercentageBased()`	Определяет, основан ли цвет этого фона на процентах (то есть относительно размера области, которая стилизуется).

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

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

Подробное описание полей

ПУСТО

public static final Background EMPTY

Пустой фон, полезный для использования вместо null.

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

Фон

public Background(BackgroundFill... fills)

Создайте новый фон, предоставив массив BackgroundFills. Этот массив может быть null или содержать значения null. Любые значения null будут игнорироваться и не будут вносить вклад в fills или outsets.

Параметры:: fills - Заполнения. Может быть null и может содержать null. Любые содержащиеся null отфильтровываются и не включаются в конечный список заполнений. Нулевой массив становится пустым списком.

Фон

public Background(BackgroundImage... images)

Создайте новый фон, предоставив массив BackgroundImages. Этот массив может быть null или содержать значения null. Любые значения null будут игнорироваться и не будут вносить вклад в images.

Параметры:: images - Изображения. Может быть null и может содержать null. Любые содержащиеся null отфильтровываются и не включаются в конечный список изображений. Нулевой массив становится пустым списком.

Фон

public Background(List<BackgroundFill> fills, List<BackgroundImage> images)

Создайте новый фон, предоставив два списка: один для заполнений фона и один для изображений фона. Любой список может быть null и может содержать значения null. Любые значения null в этих списках будут проигнорированы и не будут вносить вклад в fills, images или outsets.

Параметры:: fills - Заполнения. Может быть null и может содержать null. Любые содержащиеся null отфильтровываются и не включаются в конечный список заполнений. Null-список становится пустым списком.; images - Изображения. Может быть null и может содержать null. Любые содержащиеся null отфильтровываются и не включаются в конечный список изображений. Null-список становится пустым списком.

Фон

public Background(BackgroundFill[] fills, BackgroundImage[] images)

Создайте новый фон, предоставив два массива: один для заполнений фона и один для изображений фона. Любой массив может быть null и может содержать значения null. Любые значения null в этих массивах будут проигнорированы и не будут вносить вклад в fills, images или outsets.

Параметры:: fills - Заполнения. Может быть null и может содержать null. Любые содержащиеся null отфильтровываются и не включаются в конечный список заполнений. Null-массив становится пустым списком.; images - Изображения. Может быть null и может содержать null. Любые содержащиеся null отфильтровываются и не включаются в конечный список изображений. Null-массив становится пустым списком.

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

getClassCssMetaData

public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()

Получает CssMetaData, связанную с этим классом, которая может включать CssMetaData его суперклассов.

Возвращает:: CssMetaData

getFills

public final List<BackgroundFill> getFills()

Список BackgroundFills, которые вместе определяют заполненную часть этого фона. Этот список неизменяемый и неизменный. Он никогда не будет null. Элементы этого списка также никогда не будут null.

Тип интерполяции:: pairwise
Возвращает:: список BackgroundFills

getImages

public final List<BackgroundImage> getImages()

Список BackgroundImages, которые вместе определяют часть изображения этого фона. Этот список неизменяемый и неизменный. Он никогда не будет null. Элементы этого списка также никогда не будут null.

Тип интерполяции:: pairwise
Возвращает:: список BackgroundImages

getOutsets

public final Insets getOutsets()

Отступы этого фона. Это представляет собой наибольший ограничительный прямоугольник, внутри которого будет происходить все рисование для фона. Отступы никогда не будут отрицательными и представляют расстояние от края области наружу. Любые BackgroundImages, которые выходили бы за пределы отступов, будут обрезаны. Только BackgroundFills влияют на отступы.

Тип интерполяции:: промежуточное значение выводится из fills
Возвращает:: отступы

isEmpty

public final boolean isEmpty()

Получает, является ли фон пустым. Он пуст, если нет заполнений или изображений.

Возвращает:: true, если фон пуст, false в противном случае.

fill

public static Background fill(Paint fill)

Удобный фабричный метод для создания Background с одним Paint.

Требования к реализации:: Этот вызов эквивалентен new Background(new BackgroundFill(fill, null, null));.
Параметры:: fill - заполнение фона. Если null, Color.TRANSPARENT будет использоваться.
Возвращает:: новый фон заданного заполнения
С:: 18

isFillPercentageBased

public boolean isFillPercentageBased()

Получает, основан ли фон на процентах (то есть, относительно размера области, которая стилизуется). В частности, это возвращает true, если у любого из CornerRadii в любом из заполнений в этом фоне есть радиус, основанный на процентах.

Возвращает:: Истина, если какие-либо CornerRadii любого BackgroundFill в этом фоне вернут true, ложь в противном случае.
С:: JavaFX 8.0

interpolate

public Background interpolate(Background endValue, double t)

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

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

Определено в:: interpolate в интерфейсе Interpolatable<Background>
Параметры:: 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.