Класс BorderImage

java.lang.Object

javafx.scene.layout.BorderImage

public class BorderImage extends Object

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

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

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

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

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

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

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

Модификатор и тип	Метод	Описание
`final Image`	`getImage()`	Используемое изображение.
`final Insets`	`getInsets()`	Отступы BorderImage определяют, где рамка должна быть размещена относительно края региона.
`final BorderRepeat`	`getRepeatX()`	Указывает, каким образом (если таковой имеется) изображение рамки должно повторяться по оси x региона.
`final BorderRepeat`	`getRepeatY()`	Указывает, каким образом (если таковой имеется) изображение рамки должно повторяться по оси y региона.
`final BorderWidths`	`getSlices()`	Определяет фрагменты изображения.
`final BorderWidths`	`getWidths()`	Ширина рамки с каждой стороны.
`final 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 - Отступы, в которых нужно расположить рамку относительно региона. Значение 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 региона. Если не указано, значение по умолчанию — STRETCH.

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

getRepeatY

public final BorderRepeat getRepeatY()

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

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

getWidths

public final BorderWidths getWidths()

Ширина рамки с каждой стороны. Они могут быть определены как абсолютные ширины или проценты от размера региона, 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 определяют, где рамка должна быть размещена относительно края региона. Это значение никогда не будет 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.