Класс 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();
     }
 }