Класс SpringLayout

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

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

Вы можете изменить ограничения компонента несколькими способами. Вы можете использовать один из методов putConstraint, чтобы установить пружину, связывающую границы двух компонентов в одном контейнере. Или вы можете получить соответствующий объект ограничений с помощью getConstraints и затем изменить одну или несколько пружин. Или вы можете получить пружину для определённой границы компонента с помощью getConstraint и изменить её. Вы также можете связать свой собственный объект ограничений с компонентом, указав объект ограничений при добавлении компонента в контейнер (используя Container.add(Component, Object)).

Объект Spring, представляющий каждое ограничение, имеет минимальное, предпочтительное, максимальное и текущее значение. Текущее значение пружины находится где-то между минимальным и максимальным значениями, в соответствии со формулой, указанной в описании метода Spring.sum(javax.swing.Spring, javax.swing.Spring). Когда минимальное, предпочтительное и максимальное значения одинаковы, текущее значение всегда равно им; эта жёсткая пружина называется «стойкой». Вы можете создать стойки, используя фабричный метод Spring.constant(int). Класс Spring также предоставляет фабричные методы для создания других типов пружин, включая пружины, зависящие от других пружин.

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

SpringLayout по сравнению с другими управляющими компоновкой

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

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

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

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

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

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