Класс GridBagLayout

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

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

Для эффективного использования компоновки GridBag необходимо настроить один или несколько объектов 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 размещает всё дополнительное пространство между своей сеткой ячеек и границами контейнера.

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

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

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

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

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

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

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

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

• Button1, Button2, Button3: weightx = 1.0
• Button4: weightx = 1.0, gridwidth = GridBagConstraints.REMAINDER
• Button5: gridwidth = GridBagConstraints.REMAINDER
• Button6: gridwidth = GridBagConstraints.RELATIVE
• Button7: gridwidth = GridBagConstraints.REMAINDER
• Button8: gridheight = 2, weighty = 1.0
• Button9, Button 10: gridwidth = GridBagConstraints.REMAINDER

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

import java.awt.Button;
import java.awt.EventQueue;
import java.awt.Frame;
import java.awt.GridBagConstraints;
import java.awt.GridBagLayout;

public class GridBagLayoutExample {

    private static void addButton(String name,
                                  GridBagLayout gridbag,
                                  GridBagConstraints c,
                                  Frame frame) {
        Button button = new Button(name);
        gridbag.setConstraints(button, c);
        frame.add(button);
    }

    public static void main(String[] args) throws Exception {
        EventQueue.invokeAndWait(() -> {
            Frame frame = new Frame("GridBagLayout");
            GridBagLayout gridbag = new GridBagLayout();
            GridBagConstraints c = new GridBagConstraints();
            frame.setLayout(gridbag);

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

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

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

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

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

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

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

            frame.pack();
            frame.setVisible(true);
        });
    }
}