Класс 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), то расположение по оси X (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 отбрасывает наименее недавно установленное ограничение, чтобы формулы выполнялись.

С момента:
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

Конструкторы

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(), SpringLayout.Constraints

getX

public Spring getX()

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

Возвращает:
пружина, управляющая значением x расположения компонента
См. также:
setX(javax.swing.Spring), SpringLayout.Constraints

setY

public void setY(Spring y)

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

Параметры:
y - пружина, управляющая значением y расположения компонента
См. также:
getY(), SpringLayout.Constraints

getY

public Spring getY()

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

Возвращает:
пружина, управляющая значением y расположения компонента
См. также:
setY(javax.swing.Spring), SpringLayout.Constraints

setWidth

public void setWidth(Spring width)

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

Параметры:
width - пружина, управляющая шириной этого объекта Constraints
См. также:
getWidth(), SpringLayout.Constraints

getWidth

public Spring getWidth()

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

Возвращает:
пружина, управляющая шириной компонента
См. также:
setWidth(javax.swing.Spring), SpringLayout.Constraints

setHeight

public void setHeight(Spring height)

Устанавливает свойство height, которое управляет высотой компонента.

Параметры:
height - пружина, управляющая высотой этого объекта Constraints
См. также:
getHeight(), SpringLayout.Constraints

getHeight

public Spring getHeight()

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

Возвращает:
пружина, управляющая высотой компонента
См. также:
setHeight(javax.swing.Spring), SpringLayout.Constraints

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(java.lang.String), SpringLayout.NORTH, SpringLayout.SOUTH, SpringLayout.EAST, SpringLayout.WEST, SpringLayout.HORIZONTAL_CENTER, SpringLayout.VERTICAL_CENTER, SpringLayout.BASELINE, SpringLayout.WIDTH, SpringLayout.HEIGHT, SpringLayout.Constraints

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
См. также:
setConstraint(java.lang.String, javax.swing.Spring), SpringLayout.NORTH, SpringLayout.SOUTH, SpringLayout.EAST, SpringLayout.WEST, SpringLayout.HORIZONTAL_CENTER, SpringLayout.VERTICAL_CENTER, SpringLayout.BASELINE, SpringLayout.WIDTH, SpringLayout.HEIGHT, SpringLayout.Constraints

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

Spec-Zone .ru
спецификации, руководства, описания, API