Класс SpringLayout.Constraints

java.lang.Object

javax.swing.SpringLayout.Constraints

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

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

Параметры:

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

Возвращает:

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

Исключения:

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

См. также:

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