Класс 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 , изменяются только в том случае, если базовая строка в измененном размере помещается в области отображения. Если базовая строка такая, что не помещается в область отображения, компонент не изменяется.
• Компоненты, размещенные на базовой строке, но не имеющие корректной базовой строки, могут только увеличиваться в высоту до 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();
     }
 }