Класс SpringLayout

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

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

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

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