Класс 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), то расположение по оси 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(Component c) | Создает объект |
Constraints(Spring x,
Spring y) | Создает объект |
Constraints(Spring x,
Spring y,
Spring width,
Spring height) | Создает объект |
Методы
| Модификатор и тип | Метод | Описание |
|---|---|---|
Spring | getConstraint(String edgeName) | Возвращает значение указанной грани, которое может быть производным значением или даже |
Spring | getHeight() | Возвращает значение свойства |
Spring | getWidth() | Возвращает значение свойства |
Spring | getX() | Возвращает значение свойства |
Spring | getY() | Возвращает значение свойства |
void | setConstraint(String edgeName,
Spring s) | Устанавливает пружину, управляющую указанной гранью. |
void | setHeight(Spring height) | Устанавливает свойство |
void | setWidth(Spring width) | Устанавливает свойство |
void | setX(Spring x) | Устанавливает свойство |
void | setY(Spring 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