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

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

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

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

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

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

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

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

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