Класс BorderImage

java.lang.Object

javafx.scene.layout.BorderImage

Все реализуемые интерфейсы:: Interpolatable<BorderImage>

public final class BorderImage extends Object implements Interpolatable<BorderImage>

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

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

Модификатор и тип	Метод	Описание
`final Image`	`getImage()`	Используемое изображение.
`final Insets`	`getInsets()`	Отступы BorderImage определяют, где должна быть расположена рамка относительно края области (Region).
`final BorderRepeat`	`getRepeatX()`	Указывает, каким образом (если вообще) изображение рамки должно повторяться вдоль оси x области (region).
`final BorderRepeat`	`getRepeatY()`	Указывает, каким образом (если вообще) изображение рамки должно повторяться вдоль оси y области (region).
`final BorderWidths`	`getSlices()`	Определяет фрагменты изображения.
`final BorderWidths`	`getWidths()`	Ширина рамки с каждой стороны.
`BorderImage`	`interpolate(BorderImage endValue, double t)`	Возвращает промежуточное значение между значением этого `Interpolatable` и указанным `endValue` с использованием коэффициента линейной интерполяции `t`, изменяющегося от 0 (включительно) до 1 (включительно).
`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 - Отступы, в которых должна быть расположена рамка относительно области (region). Значение null приводит к Insets.EMPTY.; slices - Фрагменты изображения. При null, по умолчанию используется BorderImageSlices.DEFAULT; filled - Флаг, указывающий, нужно ли рисовать центральный фрагмент; repeatX - Значение повторения изображения рамки по оси x. При null, по умолчанию используется STRETCH.; repeatY - Значение повторения изображения рамки по оси y. При null, по умолчанию используется то же значение, что и repeatX.

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

getImage

public final Image getImage()

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

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

getRepeatX

public final BorderRepeat getRepeatX()

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

Тип интерполяции:: discrete
Возвращает:: BorderRepeat, указывающий, должно ли изображение рамки повторяться вдоль оси x области (region)

getRepeatY

public final BorderRepeat getRepeatY()

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

Тип интерполяции:: discrete
Возвращает:: BorderRepeat, указывающий, должно ли изображение рамки повторяться вдоль оси y области (region)

getWidths

public final BorderWidths getWidths()

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

Тип интерполяции:: default
Возвращает:: BorderWidths рамки с каждой стороны

getSlices

public final BorderWidths getSlices()

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

Тип интерполяции:

default

Возвращает:

BorderWidths, определяющие фрагменты изображения

См. также:

isFilled

public final boolean isFilled()

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

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

getInsets

public final Insets getInsets()

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

Тип интерполяции:: default
Возвращает:: отступы BorderImage

interpolate

public BorderImage interpolate(BorderImage endValue, double t)

Возвращает промежуточное значение между значением этого Interpolatable и указанным endValue с использованием коэффициента линейной интерполяции t, изменяющегося от 0 (включительно) до 1 (включительно).

Возвращаемое значение может не быть новым экземпляром; реализация также может вернуть один из двух существующих экземпляров, если промежуточное значение будет равно одному из существующих значений. Однако это оптимизация, и приложения не должны предполагать какой-либо определённой идентичности возвращаемого значения.

Указано в:: interpolate в интерфейсе Interpolatable<BorderImage>
Параметры:: endValue - целевое значение; t - коэффициент интерполяции
Возвращает:: промежуточное значение
Исключения:: NullPointerException - если endValue равно null
С тех пор:: 24

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