Класс SpringLayout.Constraints

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*

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

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

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)

Параметры:

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