Класс SpringLayout

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

У каждого дочернего компонента контейнера, управляемого SpringLayout, а также у самого контейнера есть ровно один набор связанных с ним ограничений. Эти ограничения представлены объектом 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(Spring, Spring). Если минимальное, предпочтительное и максимальное значения совпадают, текущее значение всегда равно им; такая нерастяжимая пружина называется распоркой. Распорки можно создавать с помощью фабричного метода Spring.constant(int). Класс Spring также предоставляет фабричные методы для создания других видов пружин, в том числе пружин, зависящих от других пружин.

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

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

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

В зависимости от используемых ограничений может потребоваться явно задать размер контейнера.

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

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

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

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