Класс SpringLayout

public class SpringLayout
extends Object
implements LayoutManager2

A SpringLayout компонует дочерние элементы своего связанного контейнера в соответствии с набором ограничений. Смотрите Как использовать SpringLayout в Java Tutorial для примеров использования SpringLayout.

Каждое ограничение, представленное объектом Spring, контролирует вертикальное или горизонтальное расстояние между двумя границами компонента. Границы могут принадлежать любому дочернему элементу контейнера или самому контейнеру. Например, допустимую ширину компонента можно выразить с помощью ограничения, контролирующего расстояние между западной (левой) и восточной (правой) границами компонента. Допустимые координаты y компонента можно выразить, ограничив расстояние между северной (верхней) границей компонента и северной границей его контейнера.

Каждый дочерний элемент контейнера, управляемого SpringLayout, а также сам контейнер, имеет ровно один набор ограничений, связанный с ним. Эти ограничения представлены объектом SpringLayout.Constraints. По умолчанию, SpringLayout создаёт ограничения, которые заставляют связанный компонент иметь минимальные, предпочтительные и максимальные размеры, возвращаемые методами компонента Component.getMinimumSize(), Component.getPreferredSize() и Component.getMaximumSize(). Позиции x и y изначально не ограничены, поэтому до тех пор, пока вы их не ограничите, компонент будет расположен в координатах 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 также предоставляет фабричные методы для создания других типов пружин, включая пружины, зависящие от других пружин.

В SpringLayout, положение каждой границы зависит от положения только одной другой границы. Если ограничение добавляется позже для создания новой связи для границы, предыдущая связь отбрасывается, и граница остаётся связанной с одной единственной границей. Пружины должны прикрепляться только между границами контейнера и его непосредственных дочерних элементов; поведение SpringLayout при представлении ограничений, связывающих границы компонентов из разных контейнеров (внутренних или внешних), не определено.

SpringLayout против других менеджеров компоновки

Note: Unlike many layout managers, SpringLayout doesn't automatically set the location of the components it manages. If you hand-code a GUI that uses SpringLayout, remember to initialize component locations by constraining the west/east and north/south locations.  Depending on the constraints you use, you may also need to set the size of the container explicitly.

Несмотря на простоту SpringLayout, она может эмулировать поведение большинства других менеджеров компоновки. Для некоторых функций, таких как разбиение строк, предоставляемое FlowLayout, потребуется создание специального подкласса класса Spring.

SpringLayout также предоставляет способ решения многих сложных проблем компоновки, которые не могут быть решены с помощью вложенных комбинаций Box. Тем не менее, SpringLayout правильно соблюдает контракт LayoutManager2 и поэтому может быть вложен с другими менеджерами компоновки - метод, который может быть предпочтительнее создания ограничений, подразумеваемых другими менеджерами компоновки.

Асимптотическая сложность операции компоновки SpringLayout линейна по количеству ограничений (и/или компонентов).

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими выпусками Swing. Текущая поддержка сериализации подходит для краткосрочного хранения или RMI между приложениями, использующими одну и ту же версию Swing. Начиная с 1.4, поддержка долгосрочного хранения всех JavaBeans™ была добавлена в пакет java.beans. Пожалуйста, обратитесь к XMLEncoder.