Класс GridBagLayout

public class GridBagLayout
extends Object
implements LayoutManager2, Serializable

Класс GridBagLayout — это гибкий менеджер компоновки, который выравнивает компоненты вертикально, горизонтально или по базовой линии без необходимости, чтобы компоненты были одинакового размера. Каждый объект GridBagLayout поддерживает динамическую прямоугольную сетку ячеек, причем каждый компонент занимает одну или несколько ячеек, называемую его областью отображения.

Каждый компонент, управляемый объектом GridBagLayout, связан с экземпляром GridBagConstraints. Объект ограничений определяет, где должна располагаться область отображения компонента в сетке и как компонент должен быть расположен внутри своей области отображения. Помимо своего объекта ограничений, GridBagLayout также учитывает минимальные и предпочтительные размеры каждого компонента для определения размера компонента.

Общее направление сетки зависит от свойства контейнера ComponentOrientation. Для горизонтальной ориентации слева направо координата сетки (0,0) находится в верхнем левом углу контейнера, при этом x увеличивается вправо, а y — вниз. Для горизонтальной ориентации справа налево координата сетки (0,0) находится в верхнем правом углу контейнера, при этом x увеличивается влево, а y — вниз.

Для эффективного использования компоновки сетки необходимо настроить один или несколько объектов GridBagConstraints, которые связаны с ее компонентами. Вы настраиваете объект GridBagConstraints путем установки одной или нескольких переменных экземпляра:

GridBagConstraints.gridx, GridBagConstraints.gridy

Указывает ячейку, содержащую ведущий угол области отображения компонента, где ячейка в начале сетки имеет адрес gridx = 0, gridy = 0. Для горизонтальной компоновки слева направо ведущий угол компонента — его верхний левый угол. Для горизонтальной компоновки справа налево ведущий угол компонента — его верхний правый угол. Используйте GridBagConstraints.RELATIVE (значение по умолчанию), чтобы указать, что компонент должен быть размещен непосредственно после (по оси x для gridx или оси y для gridy ) компонента, который был добавлен в контейнер перед добавлением этого компонента.

GridBagConstraints.gridwidth, GridBagConstraints.gridheight

Указывает количество ячеек в строке (для gridwidth ) или столбце (для gridheight ) в области отображения компонента. Значение по умолчанию равно 1. Используйте GridBagConstraints.REMAINDER , чтобы указать, что область отображения компонента будет от gridx до последней ячейки в строке (для gridwidth ) или от gridy до последней ячейки в столбце (для gridheight ). Используйте GridBagConstraints.RELATIVE , чтобы указать, что область отображения компонента будет от gridx до предпоследней ячейки в строке (для gridwidth ) или от gridy до предпоследней ячейки в столбце (для gridheight ).

GridBagConstraints.fill

Используется, когда область отображения компонента больше, чем запрошенный размер компонента, для определения того, следует ли и как изменять размер компонента. Возможные значения: GridBagConstraints.NONE (значение по умолчанию), GridBagConstraints.HORIZONTAL (сделать компонент достаточно широким, чтобы заполнить его область отображения по горизонтали, но не изменять его высоту), GridBagConstraints.VERTICAL (сделать компонент достаточно высоким, чтобы заполнить его область отображения по вертикали, но не изменять его ширину) и GridBagConstraints.BOTH (заполнить компонент всю область отображения полностью).

GridBagConstraints.ipadx, GridBagConstraints.ipady

Указывает внутренний отступ компонента в компоновке, сколько добавить к минимальному размеру компонента. Ширина компонента будет не менее его минимальной ширины плюс ipadx пикселей. Аналогично, высота компонента будет не менее минимальной высоты плюс ipady пикселей.

GridBagConstraints.insets

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

GridBagConstraints.anchor

Указывает, где компонент должен быть расположен в своей области отображения. Существует три типа возможных значений: абсолютные, относительные к ориентации и относительные к базовой линии. Значения, относительные к ориентации, интерпретируются относительно свойства ComponentOrientation контейнера, а абсолютные — нет. Значения, относительные к базовой линии, вычисляются относительно базовой линии. Допустимые значения:

Абсолютные значения	Значения, относительные к ориентации	Значения, относительные к базовой линии
GridBagConstraints.NORTH GridBagConstraints.SOUTH GridBagConstraints.WEST GridBagConstraints.EAST GridBagConstraints.NORTHWEST GridBagConstraints.NORTHEAST GridBagConstraints.SOUTHWEST GridBagConstraints.SOUTHEAST GridBagConstraints.CENTER (значение по умолчанию)	GridBagConstraints.PAGE_START GridBagConstraints.PAGE_END GridBagConstraints.LINE_START GridBagConstraints.LINE_END GridBagConstraints.FIRST_LINE_START GridBagConstraints.FIRST_LINE_END GridBagConstraints.LAST_LINE_START GridBagConstraints.LAST_LINE_END	GridBagConstraints.BASELINE GridBagConstraints.BASELINE_LEADING GridBagConstraints.BASELINE_TRAILING GridBagConstraints.ABOVE_BASELINE GridBagConstraints.ABOVE_BASELINE_LEADING GridBagConstraints.ABOVE_BASELINE_TRAILING GridBagConstraints.BELOW_BASELINE GridBagConstraints.BELOW_BASELINE_LEADING GridBagConstraints.BELOW_BASELINE_TRAILING

GridBagConstraints.weightx, GridBagConstraints.weighty

Используется для определения способа распределения пространства, что важно для указания поведения при изменении размера. Если не указать вес хотя бы для одного компонента в строке (weightx ) и столбце (weighty ), все компоненты сгруппируются в центре своего контейнера. Это происходит потому, что когда вес равен нулю (значение по умолчанию), объект GridBagLayout помещает любое дополнительное пространство между своей сеткой ячеек и краями контейнера.

В каждой строке может быть базовая линия; она определяется компонентами в этой строке, имеющими допустимую базовую линию и выровненными по базовой линии (значение анкерного компонента — одно из BASELINE, BASELINE_LEADING или BASELINE_TRAILING). Если ни один из компонентов в строке не имеет допустимой базовой линии, у строки нет базовой линии.

Если компонент охватывает несколько строк, он выравнивается либо по базовой линии начальной строки (если поведение изменения размера базовой линии — CONSTANT_ASCENT ), либо конечной строки (если поведение изменения размера базовой линии — CONSTANT_DESCENT ). Строка, к которой выровнен компонент, называется доминирующей строкой.

На рисунке ниже показана компоновка по базовой линии, а также компонент, охватывающий несколько строк:

Эта компоновка состоит из трех компонентов:

• Панель, начинающаяся в строке 0 и заканчивающаяся в строке 1. Панель имеет поведение изменения размера базовой линии CONSTANT_DESCENT и анкер BASELINE. Поскольку поведение изменения размера базовой линии — CONSTANT_DESCENT, доминирующей строкой для панели является строка 1.
• Две кнопки, каждая с поведением изменения размера базовой линии CENTER_OFFSET и анкером BASELINE.

Поскольку вторая кнопка и панель имеют одну и ту же доминирующую строку, обе они выровнены по своей базовой линии.

Компоненты, размещенные с помощью одного из значений, относящихся к базовой линии, меняют размер иначе, чем при использовании абсолютного или относительного к ориентации значения. Как компоненты меняют размер, определяется тем, как изменяется базовая линия доминирующей строки. Базовая линия привязана к нижней части области отображения, если какие-либо компоненты с той же доминирующей строкой имеют поведение изменения размера базовой линии CONSTANT_DESCENT, в противном случае базовая линия привязана к верхней части области отображения. Следующие правила определяют поведение изменения размера:

• Изменяемые компоненты, расположенные над базовой линией, могут расти только до уровня базовой линии. Например, если базовая линия находится на уровне 100 и привязана кверху, изменяемый компонент, расположенный над базовой линией, никогда не может вырасти более чем на 100 единиц.
• Аналогично, изменяемые компоненты, расположенные под базовой линией, могут расти только до разницы между высотой области отображения и базовой линией.
• Изменяемые компоненты, расположенные на базовой линии с поведением изменения размера базовой линии OTHER , изменяются в размере только в том случае, если базовая линия при измененном размере помещается в области отображения. Если базовая линия такова, что она не помещается в области отображения, компонент не изменяется в размере.
• Компоненты, расположенные на базовой линии, которые не имеют поведения изменения размера базовой линии OTHER , могут расти только до display height - baseline + baseline of component.

Если вы размещаете компонент вдоль базовой линии, но у компонента нет допустимой базовой линии, он будет вертикально центрирован в своем пространстве. Точно так же, если вы разместили компонент относительно базовой линии, и ни один из компонентов в строке не имеет допустимой базовой линии, компонент будет вертикально центрирован.

На следующих рисунках показано десять компонентов (все кнопки), управляемых компоновкой сетки. Рисунок 2 показывает компоновку для горизонтального контейнера слева направо, а рисунок 3 — для горизонтального контейнера справа налево.

Рисунок 2: Горизонтальная, слева направо	Рисунок 3: Горизонтальная, справа налево

У каждого из десяти компонентов поле fill связанного с ним объекта GridBagConstraints установлено в значение GridBagConstraints.BOTH. Кроме того, компоненты имеют следующие отличные от значений по умолчанию ограничения:

• Кнопка1, Кнопка2, Кнопка3: weightx = 1.0
• Кнопка4: weightx = 1.0, gridwidth = GridBagConstraints.REMAINDER
• Кнопка5: gridwidth = GridBagConstraints.REMAINDER
• Кнопка6: gridwidth = GridBagConstraints.RELATIVE
• Кнопка7: gridwidth = GridBagConstraints.REMAINDER
• Кнопка8: gridheight = 2, weighty = 1.0
• Кнопка9, Кнопка 10: gridwidth = GridBagConstraints.REMAINDER

Вот код, реализующий пример, показанный выше:

import java.awt.*;
import java.util.*;
import java.applet.Applet;

public class GridBagEx1 extends Applet {

    protected void makebutton(String name,
                              GridBagLayout gridbag,
                              GridBagConstraints c) {
        Button button = new Button(name);
        gridbag.setConstraints(button, c);
        add(button);
    }

    public void init() {
        GridBagLayout gridbag = new GridBagLayout();
        GridBagConstraints c = new GridBagConstraints();

        setFont(new Font("SansSerif", Font.PLAIN, 14));
        setLayout(gridbag);

        c.fill = GridBagConstraints.BOTH;
        c.weightx = 1.0;
        makebutton("Button1", gridbag, c);
        makebutton("Button2", gridbag, c);
        makebutton("Button3", gridbag, c);

        c.gridwidth = GridBagConstraints.REMAINDER; //end row
        makebutton("Button4", gridbag, c);

        c.weightx = 0.0;                //reset to the default
        makebutton("Button5", gridbag, c); //another row

        c.gridwidth = GridBagConstraints.RELATIVE; //next-to-last in row
        makebutton("Button6", gridbag, c);

        c.gridwidth = GridBagConstraints.REMAINDER; //end row
        makebutton("Button7", gridbag, c);

        c.gridwidth = 1;                //reset to the default
        c.gridheight = 2;
        c.weighty = 1.0;
        makebutton("Button8", gridbag, c);

        c.weighty = 0.0;                //reset to the default
        c.gridwidth = GridBagConstraints.REMAINDER; //end row
        c.gridheight = 1;               //reset to the default
        makebutton("Button9", gridbag, c);
        makebutton("Button10", gridbag, c);

        setSize(300, 100);
    }

    public static void main(String args[]) {
        Frame f = new Frame("GridBag Layout Example");
        GridBagEx1 ex1 = new GridBagEx1();

        ex1.init();

        f.add("Center", ex1);
        f.pack();
        f.setSize(f.getPreferredSize());
        f.show();
    }
}