Класс Border

java.lang.Object

javafx.scene.layout.Border

public final class Border
extends Object

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

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

Border's 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 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()`
`List<BorderImage>`	`getImages()`	Список BorderImages, которые вместе определяют изображения, используемые вместо линии для этой границы.
`Insets`	`getInsets()`	Отступы определяют расстояние от края Region до внутреннего края границы, если это расстояние неотрицательно.
`Insets`	`getOutsets()`	Отступы границы определяют внешний край рисуемой границы.
`List<BorderStroke>`	`getStrokes()`	Список BorderStrokes, которые вместе определяют линию этой границы.
`boolean`	`isEmpty()`	Получить, является ли граница пустой.

Методы, объявленные в классе 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 его суперклассов.

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()

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

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

isEmpty

public final boolean isEmpty()

Определяет, является ли Border пустым. Он пуст, если нет штрихов или изображений.

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

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