- java.lang.Object
-
- javafx.scene.layout.Background
-
public final class Background extends Object
ФонRegion. Фон — это неизменяемый объект, который содержит все данные, необходимые для отрисовки фона Region. Поскольку этот класс неизменяемый, вы можете свободно повторно использовать один и тот же фон для многих разных Region. Обратитесь к Руководству по CSS JavaFX для полного описания правил CSS для стилизации фона Region.Каждый фон состоит из
fillsи/илиimages. Ни один из списков не будет null, но один или оба могут быть пустыми. Каждый определённыйBackgroundFillотрисовывается в порядке следования, после чего каждый определённыйBackgroundImage.outsetsфона определяют любое расширение области отрисовки Region, необходимое для учёта всей отрисовки фона. Эти отступы строго определяются BackgroundFills, указанными в данном фоне, если таковые имеются, потому что все BackgroundImages обрезаются до области отрисовки и не определяют её. Значения отступов строго неотрицательны.- Since:
- JavaFX 8.0
-
Краткое описание полей
Поля Модификатор и тип Поле Описание static BackgroundEMPTYПустой фон, полезный для использования вместо null.
-
Краткое описание конструкторов
Конструкторы Конструктор Описание Background(List<BackgroundFill> fills, List<BackgroundImage> images)Создаёт новый фон, принимая два списка: один для заполнения фона, другой для изображений фона.Background(BackgroundFill... fills)Создаёт новый фон, принимая массив BackgroundFills.Background(BackgroundFill[] fills, BackgroundImage[] images)Создаёт новый фон, принимая два массива: один для заполнения фона, другой для изображений фона.Background(BackgroundImage... images)Создаёт новый фон, принимая массив BackgroundImages.
-
Краткое описание методов
Все методыСтатические методыМетоды экземпляраКонкретные методы Модификатор и тип Метод Описание booleanequals(Object o)static List<CssMetaData<? extends Styleable,?>>getClassCssMetaData()List<BackgroundFill>getFills()Список BackgroundFills, которые вместе определяют заполненную часть данного фона.List<BackgroundImage>getImages()Список BackgroundImages, которые вместе определяют часть изображения данного фона.InsetsgetOutsets()Отступы данного фона.inthashCode()booleanisEmpty()Получает, пустой ли фон.booleanisFillPercentageBased()Получает, базируется ли закраска этого фона на процентах (то есть, относительно размера регион, который стилизуется).
-
Подробное описание полей
-
EMPTY
public static final Background EMPTY
Пустой фон, полезный для использования вместо null.
-
-
Подробное описание конструкторов
-
Background
public Background(BackgroundFill... fills)
Создаёт новый фон, указав массив BackgroundFills. Этот массив может быть null или содержать null-значения. Любые null-значения будут игнорироваться и не будут учитываться вfillsилиoutsets.- Параметры:
-
fills- Заполнения. Может быть null и содержать null-значения. Любые null-значения будут отфильтрованы и не будут включены в итоговый список заполнений. Null-массив станет пустым списком.
-
Background
public Background(BackgroundImage... images)
Создаёт новый фон, указав массив BackgroundImages. Этот массив может быть null или содержать null-значения. Любые null-значения будут игнорироваться и не будут учитываться вimages.- Параметры:
-
images- Изображения. Может быть null и содержать null-значения. Любые null-значения будут отфильтрованы и не будут включены в итоговый список изображений. Null-массив станет пустым списком.
-
Background
public Background(List<BackgroundFill> fills, List<BackgroundImage> images)
Создаёт новый фон, указав два списка: один для заполнений фона, а другой для изображений фона. Любой список может быть null и содержать null-значения. Любые null-значения в этих списках будут игнорироваться и не будут учитываться вfills,imagesилиoutsets.- Параметры:
-
fills- Заполнения. Может быть null и содержать null-значения. Любые null-значения будут отфильтрованы и не будут включены в итоговый список заполнений. Null-список станет пустым списком. -
images- Изображения. Может быть null и содержать null-значения. Любые null-значения будут отфильтрованы и не будут включены в итоговый список изображений. Null-список станет пустым списком.
-
Background
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 его суперклассов.
-
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()
Отступы этого фона. Это представляет собой наибольший ограничивающий прямоугольник, внутри которого будет происходить вся отрисовка для фона. Отступы никогда не будут отрицательными и представляют собой расстояние от края области наружу. Любые BackgroundImages, которые выходят за пределы отступов, будут обрезаны. Только BackgroundFills влияют на отступы.- Возвращает:
- отступы
-
isEmpty
public final boolean isEmpty()
Определяет, пуст ли фон. Он пуст, если нет заполнений или изображений.- Возвращает:
- true, если фон пуст, иначе false.
-
isFillPercentageBased
public boolean isFillPercentageBased()
Определяет, основано ли заполнение этого фона на процентах (то есть, относительно размера области, которая стилизуется). Конкретно, это возвращает true, если у любого CornerRadii в любом из заполнений на этом фоне есть радиус, основанный на процентах.- Возвращает:
- 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.