Класс BorderWidths

java.lang.Object

fx.scene.layout.BorderWidths

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

public final class BorderWidths extends Object implements Interpolatable<BorderWidths>

Определяет ширину для четырёх компонентов (верхнего, правого, нижнего и левого). Каждая ширина определяется как ненулевое значение. Это значение может интерпретироваться как литерльное значение, или как процент от ширины или высоты области Region, в зависимости от значений topAsPercentage, rightAsPercentage, bottomAsPercentage, leftAsPercentage. Единственное допустимое отрицательное значение для верхнего, правого, нижнего и левого сторон равно AUTO.

Так как BorderWidths неизменяемый, он безопасно может использоваться в кэше и повторно использоваться между несколькими областями Region.

С:: JavaFX 8.0

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

Модификатор и тип	Поле	Описание
`static final double`	`AUTO`	При использовании BorderStroke, значение AUTO интерпретируется как значение `BorderStroke.MEDIUM` для соответствующей стороны.
`static final BorderWidths`	`DEFAULT`	Значения по умолчанию BorderWidths, используемые BorderImage при указании null.
`static final BorderWidths`	`EMPTY`	Пустой набор ширин, где все значения равны 0 и являются литерльными значениями.
`static final BorderWidths`	`FULL`	Набор ширин, представляющий 100% для каждой стороны.

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

Конструктор	Описание
`BorderWidths(double width)`	Создаёт новый BorderWidths, используя заданную ширину для всех четырёх границ, интерпретируя её как литерльное значение, а не процент.
`BorderWidths(double top, double right, double bottom, double left)`	Создаёт новый BorderWidths с заданными значениями ширины для верхнего, правого, нижнего и левого краёв.
`BorderWidths(double top, double right, double bottom, double left, boolean topAsPercentage, boolean rightAsPercentage, boolean bottomAsPercentage, boolean leftAsPercentage)`	Создаёт новый BorderWidths.

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

Модификатор и тип	Метод	Описание
`final double`	`getBottom()`	Неотрицательное значение (за исключением `AUTO`), определяющее толщину границы снизу.
`final double`	`getLeft()`	Неотрицательное значение (за исключением `AUTO`), определяющее толщину границы слева.
`final double`	`getRight()`	Неотрицательное значение (за исключением `AUTO`), определяющее толщину границы справа.
`final double`	`getTop()`	Неотрицательное значение (за исключением `AUTO`), определяющее толщину границы сверху.
`BorderWidths`	`interpolate(BorderWidths endValue, double t)`	Возвращает промежуточное значение между значением этого `Interpolatable` и заданным `endValue`, используя линейный интерполяционный коэффициент `t`, в диапазоне от 0 (включительно) до 1 (включительно).
`final boolean`	`isBottomAsPercentage()`	Указывает, должна ли свойство `bottom` интерпретироваться как процент (`true`) высоты области или нет (`false`).
`final boolean`	`isLeftAsPercentage()`	Указывает, должна ли свойство `left` интерпретироваться как процент (`true`) ширины области или нет (`false`).
`final boolean`	`isRightAsPercentage()`	Указывает, должна ли свойство `right` интерпретироваться как процент (`true`) ширины области или нет (`false`).
`final boolean`	`isTopAsPercentage()`	Указывает, должна ли свойство `top` интерпретироваться как процент (`true`) высоты области или нет (`false`).

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

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

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

AUTO

public static final double AUTO

При использовании с BorderStroke значение AUTO интерпретируется как значение BorderStroke.MEDIUM для соответствующей стороны. При использовании с BorderImage значение AUTO означает чтение соответствующего значения из BorderStroke(ов), а не ручное указание.

См. также:

DEFAULT

public static final BorderWidths DEFAULT

Значения BorderWidths по умолчанию, используемые BorderImage, когда указано значение null. Эта ширина — одинаковая для всех сторон (верх, правая, низ, левая) по 1 пикселю, интерпретируемая как абсолютная величина.

EMPTY

public static final BorderWidths EMPTY

Пустой набор ширины, где все значения равны 0 и являются абсолютными величинами.

FULL

public static final BorderWidths FULL

Набор ширины, представляющий 100% для каждой стороны.

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

BorderWidths

public BorderWidths(double width)

Создает новые BorderWidths с заданной шириной для всех четырёх границ, рассматривая эту ширину как абсолютное значение, а не процент.

Параметры:: width - Ширина границы. Не может быть отрицательной.

BorderWidths

public BorderWidths(double top, double right, double bottom, double left)

Создаёт новые BorderWidths с заданными значениями ширины для верхней, правой, нижней и левой сторон. Ни одно из этих значений не может быть отрицательным. Каждое из этих значений интерпретируется как абсолютное значение, а не процент.

Параметры:: top - Толщина границы сверху. Должна быть неотрицательной.; right - Толщина границы справа. Должна быть неотрицательной.; bottom - Толщина границы снизу. Должна быть неотрицательной.; left - Толщина границы слева. Должна быть неотрицательной.

BorderWidths

public BorderWidths(double top, double right, double bottom, double left, boolean topAsPercentage, boolean rightAsPercentage, boolean bottomAsPercentage, boolean leftAsPercentage)

Создаёт новые BorderWidths. Ни одно из значений для top, right, bottom или left не может быть отрицательным.

Параметры:: top - Толщина границы сверху. Должна быть неотрицательной.; right - Толщина границы справа. Должна быть неотрицательной.; bottom - Толщина границы снизу. Должна быть неотрицательной.; left - Толщина границы слева. Должна быть неотрицательной.; topAsPercentage - Является ли верхняя граница процентной.; rightAsPercentage - Является ли правая граница процентной.; bottomAsPercentage - Является ли нижняя граница процентной.; leftAsPercentage - Является ли левая граница процентной.

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

getTop

public final double getTop()

Неотрицательное значение (за исключением AUTO), указывающее толщину границы сверху. Это значение может быть абсолютным или процентным, в зависимости от значения свойства topAsPercentage.

Тип интерполяции:: линейная, если оба значения абсолютные или оба значения являются percentages, и оба значения не являются специальным значением AUTO; дискретная в противном случае
Возвращает:: толщину границы сверху

getRight

public final double getRight()

Неотрицательное значение (за исключением AUTO), указывающее толщину границы справа. Это значение может быть абсолютным или процентным, в зависимости от значения свойства rightAsPercentage.

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

getBottom

public final double getBottom()

Неотрицательное значение (за исключением AUTO), указывающее толщину границы снизу. Это значение может быть абсолютным или процентным, в зависимости от значения свойства bottomAsPercentage.

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

getLeft

public final double getLeft()

Неотрицательное значение (за исключением AUTO), указывающее толщину границы слева. Это значение может быть абсолютным или процентным, в зависимости от значения свойства leftAsPercentage.

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

isTopAsPercentage

public final boolean isTopAsPercentage()

Указывает, должно ли свойство top интерпретироваться как процент (true) от высоты области или нет (false).

Тип интерполяции:: дискретная
Возвращает:: true, если верхняя граница интерпретируется как процент высоты области, иначе false

isRightAsPercentage

public final boolean isRightAsPercentage()

Указывает, должно ли свойство right интерпретироваться как процент (true) от ширины области или нет (false).

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

isBottomAsPercentage

public final boolean isBottomAsPercentage()

Указывает, должно ли свойство bottom интерпретироваться как процент (true) от высоты области или нет (false).

Тип интерполяции:: дискретная
Возвращает:: true, если нижняя граница интерпретируется как процент высоты области, иначе false

isLeftAsPercentage

public final boolean isLeftAsPercentage()

Указывает, должно ли свойство left интерпретироваться как процент (true) от ширины области или нет (false).

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

interpolate

public BorderWidths interpolate(BorderWidths endValue, double t)

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

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

Определено в:: interpolate в интерфейсе Interpolatable<BorderWidths>
Параметры:: 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.