Класс 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) положение, то восточное положение рассчитывается как ЗАПАД + ШИРИНА. Если вместо этого вы указали ширину и восточное положение, то западное (X) положение рассчитывается как ВОСТОК - ШИРИНА.

[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 имеют значения null.

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

Ограничения

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

Ограничения

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. Для любого другого значения поля не выполняется никаких действий. Для поля null выбрасывается исключение.

Примечание: Этот метод может повлиять на значения 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. Для любого другого значения поля будет возвращено null. Выбрасывает NullPointerException для поля null.

Параметры:

edgeName — поле, значение которого нужно вернуть

Возвращает:

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

Исключения:

NullPointerException — если edgeName равно null

См. также:

© 1993, 2023, 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/21/docs/api/java.desktop/javax/swing/SpringLayout.Constraints.html