Класс SpringLayout.Constraints

java.lang.Object

javax.swing.SpringLayout.Constraints

Внешний класс:: SpringLayout

public static class SpringLayout.Constraints extends Object

Объект Constraints содержит ограничения, определяющие, как изменяются размер и положение компонента в контейнере, управляемом SpringLayout. Объект Constraints подобен Rectangle, поскольку имеет свойства x, y, width и height. Однако в объекте Constraints эти свойства имеют значения типа Spring, а не целочисленные значения. Кроме того, объект Constraints можно изменять, используя четыре стороны — северную, южную, восточную и западную — с помощью свойства constraint.

Для объекта Constraints всегда верны следующие формулы (здесь WEST и x являются синонимами, как и NORTH и y):

              EAST = WEST + WIDTH
             SOUTH = NORTH + HEIGHT
 HORIZONTAL_CENTER = WEST + WIDTH/2
   VERTICAL_CENTER = NORTH + HEIGHT/2
 ABSOLUTE_BASELINE = NORTH + RELATIVE_BASELINE*

Например, если вы задали значения WIDTH и WEST (X), значение EAST вычисляется как WEST + WIDTH. Если вместо этого задать значения WIDTH и EAST, значение WEST (X) вычисляется как EAST - WIDTH.

[RELATIVE_BASELINE — это закрытое ограничение, которое задаётся автоматически при вызове конструктора SpringLayout.Constraints(Component) или при регистрации объекта ограничений в объекте SpringLayout.]

Примечание: В этом документе операторы обозначают методы класса Spring. Например, «a + b» эквивалентно Spring.sum(a, b), а «a - b» эквивалентно Spring.sum(a, Spring.minus(b)). Дополнительные сведения об арифметике пружин см. в документации Spring API documentation.

Поскольку свойства объекта Constraints — представляющие его стороны, размер и положение — можно задавать независимо, хотя они и взаимосвязаны, объект Constraints может оказаться избыточно ограниченным. Например, если заданы стороны WEST, WIDTH и EAST, необходимо предпринять действия, чтобы выполнялась первая из приведённых выше формул. Для этого объект Constraints отбрасывает ограничение, заданное давнее всего, чтобы формулы выполнялись.

Начиная с версии:: 1.4

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

Конструктор	Описание
`Constraints()`	Создаёт пустой объект `Constraints`.
`Constraints(Component c)`	Создаёт объект `Constraints` с подходящими пружинами `x`, `y`, `width` и `height` для компонента `c`.
`Constraints(Spring x, Spring y)`	Создаёт объект `Constraints` с указанными значениями свойств `x` и `y`.
`Constraints(Spring x, Spring y, Spring width, Spring height)`	Создаёт объект `Constraints` с указанными значениями свойств `x`, `y`, `width` и `height`.

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

Модификатор и тип	Метод	Описание
`Spring`	`getConstraint(String edgeName)`	Возвращает значение указанной стороны, которое может быть вычисленным значением или даже `null`.
`Spring`	`getHeight()`	Возвращает значение свойства `height`.
`Spring`	`getWidth()`	Возвращает значение свойства `width`.
`Spring`	`getX()`	Возвращает значение свойства `x`.
`Spring`	`getY()`	Возвращает значение свойства `y`.
`void`	`setConstraint(String edgeName, Spring s)`	Задаёт пружину, управляющую указанной стороной.
`void`	`setHeight(Spring height)`	Задаёт свойство `height`, которое управляет высотой компонента.
`void`	`setWidth(Spring width)`	Задаёт свойство `width`, которое управляет шириной компонента.
`void`	`setX(Spring x)`	Задаёт свойство `x`, которое управляет значением `x` положения компонента.
`void`	`setY(Spring y)`	Задаёт свойство `y`, которое управляет значением `y` положения компонента.

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

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

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

Constraints

public Constraints()

Создаёт пустой объект Constraints.

Constraints

public Constraints(Spring x, Spring y)

Создаёт объект Constraints с указанными значениями свойств x и y. Пружины height и width имеют значения null.

Параметры:: x — пружина, управляющая значением x компонента; y — пружина, управляющая значением y компонента

Constraints

public Constraints(Spring x, Spring y, Spring width, Spring height)

Создаёт объект Constraints с указанными значениями свойств x, y, width и height. Примечание: если класс SpringLayout обнаруживает значения null в объекте Constraints заданного компонента, он заменяет их подходящими значениями по умолчанию.

Параметры:: x — значение пружины для свойства x; y — значение пружины для свойства y; width — значение пружины для свойства width; height — значение пружины для свойства height

Constraints

public Constraints(Component c)

Создаёт объект Constraints с подходящими пружинами x, y, width и height для компонента c. Пружины x и y — это постоянные пружины, инициализированные положением компонента на момент вызова этого метода. Пружины width и height — специальные пружины, создаваемые методами Spring.width() и Spring.height(); при изменении характеристик размера компонента они отслеживают эти изменения.

Параметры:: c — компонент, характеристики которого будут отражены в этом объекте Constraints
Исключения:: NullPointerException — если c имеет значение null.
Начиная с версии:: 1.5

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

setX

public void setX(Spring x)

Задаёт свойство x, которое управляет значением x положения компонента.

Параметры:

x — пружина, управляющая значением x положения компонента

См. также:

getX

public Spring getX()

Возвращает значение свойства x.

Возвращает:

пружину, управляющую значением x положения компонента

См. также:

setY

public void setY(Spring y)

Задаёт свойство y, которое управляет значением y положения компонента.

Параметры:

y — пружина, управляющая значением y положения компонента

См. также:

getY

public Spring getY()

Возвращает значение свойства y.

Возвращает:

пружину, управляющую значением y положения компонента

См. также:

setWidth

public void setWidth(Spring width)

Задаёт свойство width, которое управляет шириной компонента.

Параметры:

width — пружина, управляющая шириной этого объекта Constraints

См. также:

getWidth

public Spring getWidth()

Возвращает значение свойства width.

Возвращает:

пружину, управляющую шириной компонента

См. также:

setHeight

public void setHeight(Spring height)

Задаёт свойство height, которое управляет высотой компонента.

Параметры:

height — пружина, управляющая высотой этого объекта Constraints

См. также:

getHeight

public Spring getHeight()

Возвращает значение свойства height.

Возвращает:

пружину, управляющую высотой компонента

См. также:

setConstraint

public void setConstraint(String edgeName, Spring s)

Задаёт пружину, управляющую указанной стороной. Сторона должна иметь одно из следующих значений: SpringLayout.NORTH, SpringLayout.SOUTH, SpringLayout.EAST, SpringLayout.WEST, SpringLayout.HORIZONTAL_CENTER, SpringLayout.VERTICAL_CENTER, SpringLayout.BASELINE, SpringLayout.WIDTH или SpringLayout.HEIGHT. Если в качестве стороны передано любое другое значение String, никаких действий не выполняется. Для стороны null выбрасывается исключение NullPointerException.

Примечание: Этот метод может повлиять на значения x и y, ранее заданные для этого объекта Constraints.

Параметры:

edgeName — задаваемая сторона

s — пружина, управляющая указанной стороной

Исключения:

NullPointerException — если edgeName имеет значение null

См. также:

getConstraint

public Spring getConstraint(String edgeName)

Возвращает значение указанной стороны, которое может быть вычисленным значением или даже null. Сторона должна иметь одно из следующих значений: SpringLayout.NORTH, SpringLayout.SOUTH, SpringLayout.EAST, SpringLayout.WEST, SpringLayout.HORIZONTAL_CENTER, SpringLayout.VERTICAL_CENTER, SpringLayout.BASELINE, SpringLayout.WIDTH или SpringLayout.HEIGHT. Если в качестве стороны передано любое другое значение String, будет возвращено null. Для стороны null выбрасывается исключение NullPointerException.

Параметры:

edgeName — сторона, значение которой нужно вернуть

Возвращает:

пружину, управляющую указанной стороной; может быть null

Исключения:

NullPointerException — если edgeName имеет значение null

См. также:

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/SpringLayout.Constraints.html