Класс 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 — для горизонтального контейнера справа налево.

Каждый из десяти компонентов имеет поле 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();
     }
 }