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

Например, если вы указали ширину и положение по западной стороне (X), то положение по восточной стороне вычисляется как WEST + WIDTH. Если вместо этого вы указали ширину и положение по восточной стороне, то положение по западной стороне (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` расположения компонента.

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

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

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

Ограничения

public Constraints()

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

Ограничения

public Constraints(Spring x, Spring y)

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

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

Ограничения

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

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

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

Ограничения

public Constraints(Component c)

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

Параметры:: c — компонент, характеристики которого будут отражены в этом объекте Constraints
Исключения:: NullPointerException — если c равно null.
C тех пор:: 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. Для любого другого значения края никакие действия не выполняются. Для края 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 ребра.

Parameters:

edgeName - ребро, значение которого требуется вернуть

Returns:

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

Throws:

NullPointerException - если edgeName является null

See Also:

© 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/SpringLayout.Constraints.html