Класс Background

java.lang.Object

javafx.scene.layout.Background

public final class Background
extends Object

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

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

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

Since:: JavaFX 8.0

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

Поля
Модификатор и тип	Поле	Описание
`static 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.

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

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

Методы, объявленные в классе 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.

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

Background

public Background(BackgroundImage... images)

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

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

Background

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

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

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

Background

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

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

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

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

getClassCssMetaData

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

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

getFills

public final List<BackgroundFill> getFills()

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

Возвращает:: список BackgroundFills

getImages

public final List<BackgroundImage> getImages()

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

Возвращает:: список BackgroundImages

getOutsets

public final Insets getOutsets()

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

Возвращает:: отступы

isEmpty

public final boolean isEmpty()

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

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

isFillPercentageBased

public boolean isFillPercentageBased()

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

Возвращает:: True, если любой CornerRadii любого BackgroundFill на этом фоне вернет true, в противном случае false.
С тех пор как:: 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.