Класс Border

java.lang.Object

javafx.scene.layout.Border

public final class Border extends Object

Граница Region. Border — это неизменяемый объект, который обобщает весь набор данных, необходимых для отрисовки границы Region. Поскольку этот класс неизменяемый, вы можете свободно использовать один и тот же Border для многих разных Region. Обратитесь к Руководству по справочной информации CSS JavaFX для полного описания правил CSS для стилизации границы Region.

Каждый Border состоит из strokes и/или images. Ни один из списков никогда не будет null, но один или оба могут быть пустыми. При отрисовке, если не указаны изображения или ни одно изображение не загружается успешно, все линии будут отрисованы в порядке следования. Если указано какое-либо изображение и оно загружается успешно, линии не будут нарисованы, хотя они по-прежнему будут влиять на insets и outsets Border.

Border outsets определяют любое расширение области рисования Region, необходимое для учета всех операций рисования и позиционирования границ. Эти outsets определяются как BorderStroke, так и BorderImage, указанными в этом Border. outsets строго неотрицательны.

insets используются для определения внутреннего края всех границ. Оно также всегда строго неотрицательно. Region использует отступы Background и Border, а также Region's padding для определения Region insets, которые определяют область содержимого для любых дочерних элементов Region. outsets Border вместе с outsets Background и шириной и высотой Region определяют геометрические пределы Region (которые, в свою очередь, влияют на layoutBounds, boundsInLocal и boundsInParent).

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

Since:: JavaFX 8.0

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final Border`	`EMPTY`	Пустая граница, полезная для использования вместо null.

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

Конструктор	Описание
`Border(List<BorderStroke> strokes, List<BorderImage> images)`	Создаёт новую границу, передавая список BorderStrokes и BorderImages.
`Border(BorderImage... images)`	Создаёт новую границу, передавая массив BorderImages.
`Border(BorderStroke... strokes)`	Создаёт новую границу, передавая массив BorderStrokes.
`Border(BorderStroke[] strokes, BorderImage[] images)`	Создаёт новую границу, передавая массив BorderStrokes и BorderImages.

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

Модификатор и тип	Метод	Описание
`static List<CssMetaData<? extends Styleable,?>>`	`getClassCssMetaData()`	Получает `CssMetaData`, ассоциированные с этим классом, которые могут включать в себя `CssMetaData` его суперклассов.
`final List<BorderImage>`	`getImages()`	Список BorderImages, которые вместе определяют изображения для использования вместо линии для этой границы.
`final Insets`	`getInsets()`	Отступы определяют расстояние от края Region до внутреннего края границы, если это расстояние неотрицательно.
`final Insets`	`getOutsets()`	Отступы границы определяют самый внешний край границы для отрисовки.
`final List<BorderStroke>`	`getStrokes()`	Список BorderStrokes, которые вместе определяют линию этой границы.
`final boolean`	`isEmpty()`	Получает, пуста ли граница.
`static Border`	`stroke(Paint stroke)`	Удобный фабричный метод для создания твёрдой `Border` с одной `Paint`.

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

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

Подробное описание полей

ПУСТО

public static final Border EMPTY

Пустая граница, полезная для использования вместо null.

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

Граница

public Border(BorderStroke... strokes)

Создаёт новую границу, передавая массив BorderStrokes. Этот массив может быть null или содержать null-значения. Любые null-значения будут проигнорированы и не повлияют на strokes или outsets или insets.

Параметры:: strokes - Линии. Может быть null и содержать null-значения. Любые null-значения отфильтруются и не будут включены в окончательный список линий. Нулевой массив становится пустым списком. Если заданы и линии, и изображения, и хотя бы одно из указанных изображений успешно загрузится, линии не будут отображаться. Таким образом, линии могут быть определены как резервный вариант в случае, если изображение не удалось загрузить.

Граница

public Border(BorderImage... images)

Создаёт новую границу, передавая массив BorderImages. Этот массив может быть null или содержать null-значения. Любые null-значения будут проигнорированы и не повлияют на images или outsets или insets.

Параметры:: images - Изображения. Может быть null и содержать null-значения. Любые null-значения отфильтруются и не будут включены в окончательный список изображений. Нулевой массив становится пустым списком.

Граница

public Border(List<BorderStroke> strokes, List<BorderImage> images)

Создаёт новую границу, передавая список BorderStrokes и BorderImages. Эти списки могут быть null или содержать null-значения. Любые null-значения будут проигнорированы и не повлияют на strokes или images, outsets, или insets.

Параметры:: strokes - Линии. Может быть null и содержать null-значения. Любые null-значения отфильтруются и не будут включены в окончательный список линий. Нулевой массив становится пустым списком. Если заданы и линии, и изображения, и хотя бы одно из указанных изображений успешно загрузится, линии не будут отображаться. Таким образом, линии могут быть определены как резервный вариант в случае, если изображение не удалось загрузить.; images - Изображения. Может быть null и содержать null-значения. Любые null-значения отфильтруются и не будут включены в окончательный список изображений. Нулевой массив становится пустым списком.

Граница

public Border(BorderStroke[] strokes, BorderImage[] images)

Создаёт новую границу, передавая массив BorderStrokes и BorderImages. Эти массивы могут быть null или содержать null-значения. Любые null-значения будут проигнорированы и не повлияют на strokes или images, outsets, или insets.

Параметры:: strokes - Линии. Может быть null и содержать null-значения. Любые null-значения отфильтруются и не будут включены в окончательный список линий. Нулевой массив становится пустым списком. Если заданы и линии, и изображения, и хотя бы одно из указанных изображений успешно загрузится, линии не будут отображаться. Таким образом, линии могут быть определены как резервный вариант в случае, если изображение не удалось загрузить.; images - Изображения. Может быть null и содержать null-значения. Любые null-значения отфильтруются и не будут включены в окончательный список изображений. Нулевой массив становится пустым списком.

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

getClassCssMetaData

public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()

Получает CssMetaData, связанный с этим классом, который может включать CssMetaData его суперклассов.

Возвращает:: CssMetaData

getStrokes

public final List<BorderStroke> getStrokes()

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

Возвращает:: список BorderStrokes, которые вместе определяют штриховую часть этой границы

getImages

public final List<BorderImage> getImages()

Список BorderImages, которые вместе определяют изображения для использования вместо штриха для этой границы. Если этот список указан и хотя бы одно изображение в нём успешно загрузится, любые заданные strokes не будут нарисованы. Если этот список null или ни одно изображение не удалось загрузить, то любые заданные strokes будут нарисованы.

Этот список неизменяем и неизменён. Он никогда не будет null. Он никогда не будет содержать null-элементы.

Возвращает:: список BorderImages, которые вместе определяют изображения для использования вместо штриха для этой границы

getOutsets

public final Insets getOutsets()

Отступы границы определяют самую внешнюю границу, которая будет нарисована. Значения в этих отступах строго неотрицательны.

Возвращает:: отступы границы определяют самую внешнюю границу, которая будет нарисована

getInsets

public final Insets getInsets()

Отступы определяют расстояние от края области до самой внутренней границы, если это расстояние неотрицательно. Значения в этих отступах строго неотрицательны.

Возвращает:: отступы определяют расстояние от края области до самой внутренней границы

isEmpty

public final boolean isEmpty()

Получает, является ли граница пустой. Она пуста, если нет линий или изображений.

Возвращает:: true, если граница пуста, false в противном случае.

stroke

public static Border stroke(Paint stroke)

Метод-фабрика для удобства создания твёрдой Border с одной Paint.

Требования к реализации:: Этот вызов эквивалентен new Border(new BorderStroke(stroke, BorderStrokeStyle.SOLID, null, null));.
Параметры:: stroke - штрих границы (для всех сторон). Если null, Color.BLACK будет использован.
Возвращает:: новую границу заданного штриха
С:: 18

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