Класс BorderImage

java.lang.Object

javafx.scene.layout.BorderImage

public class BorderImage
extends Object

Определяет свойства, описывающие, как отобразить изображение в качестве рамки некоторого элемента Region. BorderImage обязательно должен иметь заданное изображение (не может быть null). Свойства repeatX и repeatY определяют, как изображение должно повторяться в каждом направлении. Свойство slices определяет, как разбить изображение, чтобы его можно было растянуть на весь элемент Region, а widths определяет область в элементе Region, которую следует заполнить изображением рамки. Наконец, outsets определяют расстояние от края рамки, на которое рамка расширяется наружу. Значения смещений BorderImage влияют на значения смещений Border, которые, в свою очередь, влияют на границы элемента Region.

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

При применении к элементу Region с определенной формой BorderImage игнорируется.

С момента:: JavaFX 8.0

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

Конструкторы
Конструктор	Описание
`BorderImage(Image image, BorderWidths widths, Insets insets, BorderWidths slices, boolean filled, BorderRepeat repeatX, BorderRepeat repeatY)`	Создает новый BorderImage.

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

Модификатор и тип	Метод	Описание
`Image`	`getImage()`	Используемое изображение.
`Insets`	`getInsets()`	Смещения BorderImage определяют, где должна размещаться рамка относительно края элемента Region.
`BorderRepeat`	`getRepeatX()`	Указывает, каким образом (если таковой имеется) изображение рамки должно повторяться по оси x элемента Region.
`BorderRepeat`	`getRepeatY()`	Указывает, каким образом (если таковой имеется) изображение рамки должно повторяться по оси y элемента Region.
`BorderWidths`	`getSlices()`	Определяет фрагменты изображения.
`BorderWidths`	`getWidths()`	Ширина рамки с каждой стороны.
`boolean`	`isFilled()`	Указывает, нужно ли рисовать центральный фрагмент (определяемый левыми, правыми, верхними и нижними фрагментами).

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

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

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

BorderImage

public BorderImage(Image image, BorderWidths widths, Insets insets, BorderWidths slices, boolean filled, BorderRepeat repeatX, BorderRepeat repeatY)

Создает новый BorderImage. Изображение должно быть указано, иначе будет брошено NullPointerException.

Параметры:: image - Используемое изображение. Не должно быть null.; widths - Ширина рамки в каждом измерении. Значение null приводит к Insets.EMPTY.; insets - Смещения, относительно которых рамка должна располагаться по отношению к элементу region. Значение null приводит к Insets.EMPTY.; slices - Фрагменты изображения. Если null, используется BorderImageSlices.DEFAULT; filled - Флаг, указывающий, нужно ли рисовать центральный фрагмент; repeatX - Значение повторения для изображения рамки в направлении x. Если null, по умолчанию используется STRETCH.; repeatY - Значение повторения для изображения рамки в направлении y. Если null, используется то же значение, что и repeatX.

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

getImage

public final Image getImage()

Используемое изображение. Оно никогда не будет null. Если это изображение не загружается, весь BorderImage будет пропущен во время отрисовки и не будет участвовать в вычислении границ или других вычислений.

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

getRepeatX

public final BorderRepeat getRepeatX()

Указывает, каким образом (если таковой имеется) изображение рамки должно повторяться по оси x элемента Region. Если не указано, по умолчанию используется STRETCH.

Возвращает:: BorderRepeat, указывающий, повторяется ли изображение рамки по оси x элемента Region

getRepeatY

public final BorderRepeat getRepeatY()

Указывает, каким образом (если таковой имеется) изображение рамки должно повторяться по оси y элемента Region. Если не указано, по умолчанию используется STRETCH.

Возвращает:: BorderRepeat, указывающий, повторяется ли изображение рамки по оси y элемента Region

getWidths

public final BorderWidths getWidths()

Ширина рамки с каждой стороны. Эти значения могут быть определены либо как абсолютные значения, либо как процент от размера элемента Region. BorderWidths для получения дополнительной информации. Если null, по умолчанию используется ширина в 1 пиксель.

Возвращает:: BorderWidths рамки с каждой стороны

getSlices

public final BorderWidths getSlices()

Определяет фрагменты изображения. JavaFX использует схему из 4 фрагментов, где фрагменты делят изображение на 9 блоков. Верхний левый фрагмент определяет верхний левый угол рамки. Верхний фрагмент определяет верхнюю границу, и изображение, составляющее этот фрагмент, растягивается по горизонтали (или по тому, что определено для repeatX) для заполнения всего необходимого пространства. Верхний правый фрагмент находится в верхнем правом углу, а правый фрагмент растягивается по вертикали (или по тому, что определено для repeatY) для заполнения всего необходимого пространства. И так далее. Центральный фрагмент растягивается (или по тому, что определено для repeatX, repeatY) в каждом измерении. По умолчанию центральный фрагмент опускается (т. е. не рисуется), хотя значение BorderImageSlices, равное true для свойства filled, заставит нарисовать центральный фрагмент. Значение по умолчанию для этого свойства приведет к BorderImageSlices.DEFAULT, что является фрагментом изображения рамки, составляющим 100%.

Возвращает:: BorderWidths, определяющие фрагменты изображения
См. также:: border-image-slice

isFilled

public final boolean isFilled()

Указывает, нужно ли рисовать центральный фрагмент (определяемый левыми, правыми, верхними и нижними фрагментами).

Возвращает:: true, если центральный фрагмент должен быть нарисован

getInsets

public final Insets getInsets()

Смещения BorderImage определяют, где должна размещаться рамка относительно края элемента Region. Это значение никогда не будет null.

Возвращает:: смещения BorderImage

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