Класс Background

java.lang.Object

javafx.scene.layout.Background

public final class Background extends Object

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

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

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

Since:: JavaFX 8.0

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

Modifier and Type	Field	Description
`static final Background`	`EMPTY`	Пустой Background, полезный для использования вместо null.

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

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

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

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

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

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

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

EMPTY

public static final Background EMPTY

Пустой фон, полезный в качестве альтернативы null.

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

Background

public Background(BackgroundFill... fills)

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

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

Background

public Background(BackgroundImage... images)

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

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

Background

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

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

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

Background

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

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

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

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

getClassCssMetaData

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

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

Returns:: the CssMetaData

getFills

public final List<BackgroundFill> getFills()

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

Returns:: список BackgroundFills

getImages

public final List<BackgroundImage> getImages()

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

Returns:: список BackgroundImages

getOutsets

public final Insets getOutsets()

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

Returns:: отступы

isEmpty

public final boolean isEmpty()

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

Returns:: true, если фон пустой, иначе false.

fill

public static Background fill(Paint fill)

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

Implementation Requirements:: Этот вызов эквивалентен new Background(new BackgroundFill(fill, null, null));.
Parameters:: fill - заполнение фона. Если null, то будет использоваться Color.TRANSPARENT.
Returns:: новый фон заданного заполнения
Since:: 18

isFillPercentageBased

public boolean isFillPercentageBased()

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

Returns:: True, если какой-либо CornerRadii любого BackgroundFill на этом фоне возвращает true, в противном случае false.
Since:: JavaFX 8.0

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