Класс 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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удалён в будущей версии. Финализация устарела и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Приостанавливает текущий поток до пробуждения, обычно в результате вызова notify или прерывания.
`final void`	`wait(long timeoutMillis)`	Приостанавливает текущий поток до пробуждения, обычно в результате вызова notify или прерывания, либо до истечения заданного промежутка времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Приостанавливает текущий поток до пробуждения, обычно в результате вызова notify или прерывания, либо до истечения заданного промежутка времени.

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

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. Для границы NullPointerException возникает исключение null.

Параметры:

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.