- java.lang.Object
-
- javafx.scene.layout.BorderImage
-
public class BorderImage extends Object
Определяет свойства, описывающие, как отобразить изображение в качестве рамки некоторой области Region. У BorderImage должно быть указано изображение (не может быть null). СвойстваrepeatXиrepeatYопределяют, как изображение должно повторяться в каждом направлении. Свойствоslicesопределяет, как разделить изображение таким образом, чтобы его можно было растянуть на область Region, аwidthsопределяет область в Region, которую следует заполнить изображением рамки. Наконец,outsetsопределяют расстояние наружу от края рамки, на котором рамка расширяется. Выступы BorderImage вносят вклад в выступы рамки, которые в свою очередь вносят вклад в границы области Region.Поскольку BorderImage является неизменяемым, его можно безопасно использовать в любом кэше и повторно использовать в нескольких областях Region.
При применении к области Region с определенной формой BorderImage игнорируется.
- Since:
- JavaFX 8.0
-
Краткое описание конструкторов
Конструкторы Конструктор Описание BorderImage(Image image, BorderWidths widths, Insets insets, BorderWidths slices, boolean filled, BorderRepeat repeatX, BorderRepeat repeatY)Создаёт новый BorderImage.
-
Краткое описание методов
Все методыМетоды экземпляраКонкретные методы Модификатор и тип Метод Описание booleanequals(Object o)ImagegetImage()Используемое изображение.InsetsgetInsets()Выступы BorderImage определяют, где должна располагаться рамка относительно края области Region.BorderRepeatgetRepeatX()Указывает способ (если таковой есть) повторения изображения рамки вдоль оси x области.BorderRepeatgetRepeatY()Указывает способ (если таковой есть) повторения изображения рамки вдоль оси y области.BorderWidthsgetSlices()Определяет фрагменты изображения.BorderWidthsgetWidths()Ширина рамки с каждой стороны.inthashCode()booleanisFilled()Указывает, следует ли рисовать центральную область (как определено левым, правым, верхним и нижним фрагментами).
-
Подробное описание конструкторов
-
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()
Ширина рамки с каждой стороны. Они могут быть определены как абсолютные значения ширины или проценты от размера области Region,BorderWidthsдля получения более подробной информации. Если null, по умолчанию будет 1 пиксель.- Возвращает:
- BorderWidths рамки с каждой стороны
-
getSlices
public final BorderWidths getSlices()
Определяет фрагменты изображения. JavaFX использует схему из 4 фрагментов, где фрагменты делят изображение на 9 областей. Левый верхний фрагмент определяет левый верхний угол рамки. Верхний фрагмент определяет верхнюю рамку, и изображение, составляющее этот фрагмент, растягивается по горизонтали (или по тому, что определено для repeatX) для заполнения всего необходимого пространства. Правый верхний фрагмент идёт в правый верхний угол, и правый фрагмент растягивается по вертикали (или по тому, что определено для repeatY) для заполнения всего необходимого пространства и т. д. Центральный фрагмент растягивается (или по тому, что определено для repeatX, repeatY) по каждому измерению. По умолчанию центральный фрагмент опускается (то есть не рисуется), хотя значение BorderImageSlicestrueдля свойства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.