SpringLayout (Платформа Java SE 8 b92)

java.lang. Объект
- javax.swing. SpringLayout

Все Реализованные Интерфейсы:

LayoutManager, LayoutManager2
```
public class SpringLayout
extends Object
implements LayoutManager2
```
A SpringLayout размечает дочерние элементы его связанного контейнера согласно ряду ограничений. См., Как Использовать SpringLayout в Учебном руководстве по Java для примеров использования SpringLayout.
Каждое ограничение, представленное a Spring объект, управляет вертикалью или горизонтальным расстоянием между двумя компонентными краями. Края могут принадлежать любому дочернему элементу контейнера, или к контейнеру непосредственно. Например, допустимый width компонента может быть выражен, используя ограничение, которое управляет расстоянием между (оставленным) западом и восточными (правильными) краями компонента. Допустимые координаты y для компонента могут быть выражены, ограничивая расстояние между северным (главным) краем компонента и северным краем его контейнера.
Каждый дочерний элемент a SpringLayout- у управляемого контейнера, так же как контейнера непосредственно, есть точно один набор ограничений, связанных с этим. Эти ограничения представляются a SpringLayout.Constraints объект. По умолчанию, SpringLayout создает ограничения, которые заставляют их связанный компонент иметь минимум, предпочтенные, и максимальные размеры, возвращенные компонентом Component.getMinimumSize(), Component.getPreferredSize(), и Component.getMaximumSize() методы. X и y позиции первоначально не ограничиваются, так, чтобы, пока Вы не ограничиваете их Component будет расположен в 0,0 относительно Insets из родителя Container.
Можно изменить ограничения компонента несколькими способами. Можно использовать один из putConstraint методы, чтобы установить пружину, соединяющую края двух компонентов в пределах того же самого контейнера. Или можно получить соответствующее SpringLayout.Constraints объектное использование getConstraints и затем измените один или больше его пружин. Или можно получить пружину для определенного края компонентного использования getConstraint, и измените это. Можно также связать свое собственное SpringLayout.Constraints объект с компонентом, определяя ограничения возражает, когда Вы добавляете компонент к его контейнеру (использование Container.add(Component, Object)).
Spring у объекта, представляющего каждое ограничение, есть минимум, предпочтенный, максимум, и текущая стоимость. Текущая стоимость пружины где-нибудь между минимальными и максимальными значениями согласно формуле, поданной Spring.sum(javax.swing.Spring, javax.swing.Spring) описание метода. Когда минимум, предпочтенные, и максимальные значения являются тем же самым, текущая стоимость всегда равна им; эту негибкую пружину вызывают распоркой. Можно создать распорки, используя метод фабрики Spring.constant(int). Spring class также обеспечивает методы фабрики для того, чтобы они создали другие виды пружин, включая пружины, которые зависят от других пружин.
В a SpringLayout, позиция каждого края зависит от позиции только одного другого края. Если ограничение впоследствии добавляется, чтобы создать новую привязку для края, предыдущая привязка отбрасывается, и край остается зависящим от единственного края. Спрингс должен только быть присоединен между краями контейнера и его непосредственных дочерних элементов; поведение SpringLayout когда подарено ограничения, соединяющие края компонентов от различных контейнеров (или внутренний или внешний), неопределено.
SpringLayout по сравнению с Другими менеджерами по Расположению

Отметьте: В отличие от многих менеджеров по расположению, SpringLayout автоматически не устанавливает расположение компонентов, которыми оно управляет. Если Вы ручной код GUI, который использует SpringLayout, не забудьте инициализировать компонентные расположения, ограничивая западные/восточные и северные/южные расположения.
В зависимости от ограничений Вы используете, Вы, возможно, также должны установить размер контейнера явно.

Несмотря на простоту SpringLayout, это может эмулировать поведение большинства других менеджеров по расположению. Для некоторых функций, таких как повреждение строки, обеспеченное FlowLayout, Вы должны будете создать подкласс специального назначения Spring class.
SpringLayout также обеспечивает способ решить многие из трудных проблем расположения, которые не могут быть решены комбинациями вложения Boxes. Однако SpringLayout почести LayoutManager2 заключите контракт правильно, и так может быть вложен с другими менеджерами по расположению - метод, который может быть предпочтительным для создания ограничений, подразумеваемых другими менеджерами по расположению.
Асимптотическая сложность работы расположения a SpringLayout линейно в числе ограничений (и/или компоненты).
Предупреждение: Сериализированные объекты этого class не будут совместимыми с будущими выпусками Swing. Текущая поддержка сериализации является подходящей для краткосрочного хранения или RMI между приложениями, выполняющими ту же самую версию Swing. С 1.4, поддержка длительного хранения всего ^JavaBeansTM была добавлена к java.beans пакет. Пожалуйста, см. XMLEncoder.

С тех пор:

1.4

См. Также:

Spring, SpringLayout.Constraints

Вложенная Сводка Класса

Вложенные Классы
Модификатор и Тип	Класс и Описание
`static class`	`SpringLayout. Ограничения` A `Constraints` объект содержит ограничения, которые управляют путем размер компонента и изменение позиции в контейнере, которым управляет a `SpringLayout`.

Полевая Сводка

Поля
Модификатор и Тип	Поле и Описание
`static String`	`БАЗОВАЯ ЛИНИЯ` Определяет базовую линию компонента.
`static String`	`ВОСТОК` Определяет правый край ограничительного прямоугольника компонента.
`static String`	`ВЫСОТА` Определяет height ограничительного прямоугольника компонента.
`static String`	`HORIZONTAL_CENTER` Определяет горизонтальный центр ограничительного прямоугольника компонента.
`static String`	`СЕВЕР` Определяет главный край ограничительного прямоугольника компонента.
`static String`	`ЮГ` Определяет базовый край ограничительного прямоугольника компонента.
`static String`	`VERTICAL_CENTER` Определяет вертикальный центр ограничительного прямоугольника компонента.
`static String`	`ЗАПАД` Определяет левый край ограничительного прямоугольника компонента.
`static String`	`ШИРИНА` Определяет width ограничительного прямоугольника компонента.

Сводка конструктора

Конструкторы
Конструктор и Описание

SpringLayout()
Создает новое SpringLayout.

Конструкторы
Конструктор и Описание
`SpringLayout()` Создает новое `SpringLayout`.

Сводка метода

Все Методы Методы экземпляра Конкретные Методы
Модификатор и Тип	Метод и Описание
`void`	`addLayoutComponent(Component component, Object constraints)` Если `constraints` экземпляр `SpringLayout.Constraints`, связывает ограничения с указанным компонентом.
`void`	`addLayoutComponent(String name, Component c)` Не имеет никакого эффекта, так как этот менеджер по расположению не использует строку на компонент.
`Spring`	`getConstraint(String edgeName, Component c)` Возвращает пружину, управляющую расстоянием между указанным краем компонента и главным или левым краем его родителя.
`SpringLayout. Ограничения`	`getConstraints(Component c)` Возвращает ограничения для указанного компонента.
`float`	`getLayoutAlignmentX(Container p)` Возвраты 0.5f (центрируемый).
`float`	`getLayoutAlignmentY(Container p)` Возвраты 0.5f (центрируемый).
`void`	`invalidateLayout(Container p)` Лишает законной силы расположение, указывая, что, если менеджер по расположению кэшировал информацию, это должно быть отброшено.
`void`	`layoutContainer(Container parent)` Размечает указанный контейнер.
`Размерность`	`maximumLayoutSize(Container parent)` Вычисляет максимальные размерности размера для указанного контейнера, учитывая компоненты, которые он содержит.
`Размерность`	`minimumLayoutSize(Container parent)` Вычисляет минимальные размерности размера для указанного контейнера, учитывая компоненты, которые он содержит.
`Размерность`	`preferredLayoutSize(Container parent)` Вычисляет привилегированные размерности размера для указанного контейнера, учитывая компоненты, которые он содержит.
`void`	`putConstraint(String e1, Component c1, int pad, String e2, Component c2)` Край ссылок `e1` из компонента `c1` ограничиваться `e2` из компонента `c2`, с фиксированным расстоянием между краями.
`void`	`putConstraint(String e1, Component c1, Spring s, String e2, Component c2)` Край ссылок `e1` из компонента `c1` ограничиваться `e2` из компонента `c2`.
`void`	`removeLayoutComponent(Component c)` Удаляет ограничения, связанные с указанным компонентом.

Методы, наследованные от class java.lang. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Полевая Деталь
  - СЕВЕР
```
public static final String NORTH
```
    Определяет главный край ограничительного прямоугольника компонента.
    
    См. Также:
    
    Постоянные Значения полей
  - ЮГ
```
public static final String SOUTH
```
    Определяет базовый край ограничительного прямоугольника компонента.
    
    См. Также:
    
    Постоянные Значения полей
  - ВОСТОК
```
public static final String EAST
```
    Определяет правый край ограничительного прямоугольника компонента.
    
    См. Также:
    
    Постоянные Значения полей
  - ЗАПАД
```
public static final String WEST
```
    Определяет левый край ограничительного прямоугольника компонента.
    
    См. Также:
    
    Постоянные Значения полей
  - HORIZONTAL_CENTER
```
public static final String HORIZONTAL_CENTER
```
    Определяет горизонтальный центр ограничительного прямоугольника компонента.
    
    С тех пор:
    
    1.6
    
    См. Также:
    
    Постоянные Значения полей
  - VERTICAL_CENTER
```
public static final String VERTICAL_CENTER
```
    Определяет вертикальный центр ограничительного прямоугольника компонента.
    
    С тех пор:
    
    1.6
    
    См. Также:
    
    Постоянные Значения полей
  - БАЗОВАЯ ЛИНИЯ
```
public static final String BASELINE
```
    Определяет базовую линию компонента.
    
    С тех пор:
    
    1.6
    
    См. Также:
    
    Постоянные Значения полей
  - ШИРИНА
```
public static final String WIDTH
```
    Определяет width ограничительного прямоугольника компонента.
    
    С тех пор:
    
    1.6
    
    См. Также:
    
    Постоянные Значения полей
  - ВЫСОТА
```
public static final String HEIGHT
```
    Определяет height ограничительного прямоугольника компонента.
    
    С тех пор:
    
    1.6
    
    См. Также:
    
    Постоянные Значения полей
- Деталь конструктора
  - SpringLayout
```
public SpringLayout()
```
    Создает новое SpringLayout.
- Деталь метода
  - addLayoutComponent
```
public void addLayoutComponent(String name,
                               Component c)
```
    Не имеет никакого эффекта, так как этот менеджер по расположению не использует строку на компонент.
    
    Определенный:
    
    addLayoutComponent в интерфейсе LayoutManager
    
    Параметры:
    
    name - строка, которая будет связана с компонентом
    
    c - компонент, который будет добавлен
  - removeLayoutComponent
```
public void removeLayoutComponent(Component c)
```
    Удаляет ограничения, связанные с указанным компонентом.
    
    Определенный:
    
    removeLayoutComponent в интерфейсе LayoutManager
    
    Параметры:
    
    c - компонент, удаляемый из контейнера
  - minimumLayoutSize
```
public Dimension minimumLayoutSize(Container parent)
```
    Описание скопировало с интерфейса: LayoutManager
    
    Вычисляет минимальные размерности размера для указанного контейнера, учитывая компоненты, которые он содержит.
    
    Определенный:
    
    minimumLayoutSize в интерфейсе LayoutManager
    
    Параметры:
    
    parent - компонент, который будет размечен
    
    См. Также:
    
    LayoutManager.preferredLayoutSize(java.awt.Container)
  - preferredLayoutSize
```
public Dimension preferredLayoutSize(Container parent)
```
    Описание скопировало с интерфейса: LayoutManager
    
    Вычисляет привилегированные размерности размера для указанного контейнера, учитывая компоненты, которые он содержит.
    
    Определенный:
    
    preferredLayoutSize в интерфейсе LayoutManager
    
    Параметры:
    
    parent - контейнер, который будет размечен
    
    См. Также:
    
    LayoutManager.minimumLayoutSize(java.awt.Container)
  - maximumLayoutSize
```
public Dimension maximumLayoutSize(Container parent)
```
    Описание скопировало с интерфейса: LayoutManager2
    
    Вычисляет максимальные размерности размера для указанного контейнера, учитывая компоненты, которые он содержит.
    
    Определенный:
    
    maximumLayoutSize в интерфейсе LayoutManager2
    
    См. Также:
    
    Component.getMaximumSize(), LayoutManager
  - addLayoutComponent
```
public void addLayoutComponent(Component component,
                               Object constraints)
```
    Если constraints экземпляр SpringLayout.Constraints, связывает ограничения с указанным компонентом.
    
    Определенный:
    
    addLayoutComponent в интерфейсе LayoutManager2
    
    Параметры:
    
    component - добавляемый компонент
    
    constraints - ограничения компонента
    
    См. Также:
    
    SpringLayout.Constraints
  - getLayoutAlignmentX
```
public float getLayoutAlignmentX(Container p)
```
    Возвраты 0.5f (центрируемый).
    
    Определенный:
    
    getLayoutAlignmentX в интерфейсе LayoutManager2
  - getLayoutAlignmentY
```
public float getLayoutAlignmentY(Container p)
```
    Возвраты 0.5f (центрируемый).
    
    Определенный:
    
    getLayoutAlignmentY в интерфейсе LayoutManager2
  - invalidateLayout
```
public void invalidateLayout(Container p)
```
    Описание скопировало с интерфейса: LayoutManager2
    
    Лишает законной силы расположение, указывая, что, если менеджер по расположению кэшировал информацию, это должно быть отброшено.
    
    Определенный:
    
    invalidateLayout в интерфейсе LayoutManager2
  - putConstraint
```
public void putConstraint(String e1,
                          Component c1,
                          int pad,
                          String e2,
                          Component c2)
```
    Край ссылок e1 из компонента c1 ограничиваться e2 из компонента c2, с фиксированным расстоянием между краями. Это ограничение вызовет присвоение
```
     value(e1, c1) = value(e2, c2) + pad
```
    иметь место во время всех последующих операций расположения.
    Параметры:
    
    e1 - край зависимого
    
    c1 - компонент зависимого
    
    pad - фиксированное расстояние между зависимым и привязкой
    
    e2 - край привязки
    
    c2 - компонент привязки
    
    См. Также:
    
    putConstraint(String, Component, Spring, String, Component)
  - putConstraint
```
public void putConstraint(String e1,
                          Component c1,
                          Spring s,
                          String e2,
                          Component c2)
```
    Край ссылок e1 из компонента c1 ограничиваться e2 из компонента c2. Как край (e2, c2) значение изменений, край (e1, c1) будет вычислен, беря (пружинную) сумму (e2, c2) и s. У каждого края должно быть одно из следующих значений: SpringLayout.NORTH, SpringLayout.SOUTH, SpringLayout.EAST, SpringLayout.WEST, SpringLayout.VERTICAL_CENTER, SpringLayout.HORIZONTAL_CENTER или SpringLayout.BASELINE.
    
    Параметры:
    
    e1 - край зависимого
    
    c1 - компонент зависимого
    
    s - пружина, соединяющаяся зависимый и привязка
    
    e2 - край привязки
    
    c2 - компонент привязки
    
    См. Также:
    
    putConstraint(String, Component, int, String, Component), NORTH, SOUTH, EAST, WEST, VERTICAL_CENTER, HORIZONTAL_CENTER, BASELINE
  - getConstraints
```
public SpringLayout.Constraints getConstraints(Component c)
```
    Возвращает ограничения для указанного компонента. Отметьте это, в отличие от этого GridBagLayout getConstraints метод, этот метод не клонирует ограничения. Если никакие ограничения не были связаны с этим компонентом, этот метод возвращает ограничительный объект значения по умолчанию, расположенный в 0,0 относительно Вставок родителя и его width/height ограниченный к минимуму, максимуму, и предпочел размеры компонента. Характеристики размера не замораживаются в то время, когда этот метод вызывают; вместо этого этот метод возвращает ограничительный объект, характеристики которого отслеживают характеристики компонента, как они изменяются.
    
    Параметры:
    
    c - компонент, ограничения которого будут возвращены
    
    Возвраты:
    
    ограничения для указанного компонента
  - getConstraint
```
public Spring getConstraint(String edgeName,
                            Component c)
```
    Возвращает пружину, управляющую расстоянием между указанным краем компонента и главным или левым краем его родителя. Этот метод, вместо того, чтобы возвратить текущую привязку для края, возвращает прокси, который отслеживает характеристики края, даже если край является впоследствии восстановлением. Прокси предназначаются, чтобы использоваться в разработчике envonments, где полезно позволить пользователю определять ограничения для расположения в любом порядке. Прокси действительно, однако, обеспечивают средства создать циклические зависимости среди ограничений расположения. Такие циклы обнаруживаются внутренне SpringLayout так, чтобы работа расположения всегда завершилась.
    
    Параметры:
    
    edgeName - должен быть один из SpringLayout.NORTH, SpringLayout.SOUTH, SpringLayout.EAST, SpringLayout.WEST, SpringLayout.VERTICAL_CENTER, SpringLayout.HORIZONTAL_CENTER или SpringLayout.BASELINE
    
    c - компонент, граничная пружина которого требуется
    
    Возвраты:
    
    прокси для пружины, управляющей расстоянием между указанным краем и главным или левым краем его родителя
    
    См. Также:
    
    NORTH, SOUTH, EAST, WEST, VERTICAL_CENTER, HORIZONTAL_CENTER, BASELINE
  - layoutContainer
```
public void layoutContainer(Container parent)
```
    Описание скопировало с интерфейса: LayoutManager
    
    Размечает указанный контейнер.
    
    Определенный:
    
    layoutContainer в интерфейсе LayoutManager
    
    Параметры:
    
    parent - контейнер, который будет размечен

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

Класс SpringLayout

SpringLayout по сравнению с Другими менеджерами по Расположению

Вложенная Сводка Класса

Полевая Сводка

Сводка конструктора

Сводка метода

Методы, наследованные от class java.lang. Объект

Полевая Деталь

СЕВЕР

ЮГ

ВОСТОК

ЗАПАД

HORIZONTAL_CENTER

VERTICAL_CENTER

БАЗОВАЯ ЛИНИЯ

ШИРИНА

ВЫСОТА

Деталь конструктора

SpringLayout

Деталь метода

addLayoutComponent

removeLayoutComponent

minimumLayoutSize

preferredLayoutSize

maximumLayoutSize

addLayoutComponent

getLayoutAlignmentX

getLayoutAlignmentY

invalidateLayout

putConstraint

putConstraint

getConstraints

getConstraint

layoutContainer