Класс 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.