Класс Border

java.lang.Object

javafx.scene.layout.Border

Все реализованные интерфейсы:: Interpolatable<Border>

public final class Border extends Object implements Interpolatable<Border>

Граница 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-панельных изображений. В таких случаях вы также можете указать штриховую границу, которая используется только в том случае, если изображение не загрузилось по какой-либо причине.

С:: 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()`	Отступы определяют расстояние от края области до внутреннего края границы, если это расстояние неотрицательное.
`final Insets`	`getOutsets()`	Отступы границы определяют внешний край границы, который должен быть нарисован.
`final List<BorderStroke>`	`getStrokes()`	Список BorderStrokes, которые вместе определяют штриховую часть этой границы.
`Border`	`interpolate(Border endValue, double t)`	Возвращает промежуточное значение между значением этого `Interpolatable` и указанным `endValue`, используя коэффициент линейной интерполяции `t`, изменяющийся от 0 (включительно) до 1 (включительно).
`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-значения будут отфильтрованы и не будут включены в конечный список границ. Массив null станет пустым списком. Если указаны и границы, и изображения, и если хоть одно из указанных изображений успешно загрузится, то границы не будут отображаться. Таким образом, границы могут быть определены как резервный вариант в случае, если изображение не загрузилось.

Граница

public Border(BorderImage... images)

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

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

Граница

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

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

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

Граница

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

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

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

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

getClassCssMetaData

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

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

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

getStrokes

public final List<BorderStroke> getStrokes()

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

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

getImages

public final List<BorderImage> getImages()

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

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

Тип интерполяции:: pairwise
Возвращает:: список 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

interpolate

public Border interpolate(Border endValue, double t)

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

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

Указано в:: interpolate в интерфейсе Interpolatable<Border>
Параметры:: 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.