Класс GridLayout

public class GridLayout
extends Object
implements LayoutManager, Serializable

Класс GridLayout — это менеджер компоновки, который выкладывает компоненты контейнера в прямоугольную сетку. Контейнер делится на прямоугольники равного размера, и в каждый прямоугольник помещается один компонент. Например, следующий апплет выкладывает шесть кнопок в три строки и два столбца:

import java.awt.*;
import java.applet.Applet;
public class ButtonGrid extends Applet {
    public void init() {
        setLayout(new GridLayout(3,2));
        add(new Button("1"));
        add(new Button("2"));
        add(new Button("3"));
        add(new Button("4"));
        add(new Button("5"));
        add(new Button("6"));
    }
}

Если свойство контейнера ComponentOrientation имеет горизонтальное направление и слева направо, то вышеприведенный пример отображает результат, показанный на рисунке 1. Если свойство контейнера ComponentOrientation имеет горизонтальное направление и справа налево, то пример отображает результат, показанный на рисунке 2.

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

Когда и количество строк, и количество столбцов установлены в ненулевые значения, либо через конструктор, либо методами setRows и setColumns, указанное количество столбцов игнорируется. Вместо этого, количество столбцов определяется исходя из указанного количества строк и общего количества компонентов в компоновке. Например, если указано три строки и два столбца, а в компоновку добавлено девять компонентов, они будут отображены как три строки по три столбца. Указание количества столбцов влияет на компоновку только тогда, когда количество строк установлено в ноль.

Конструкторы

GridLayout

public GridLayout()

Создаёт макет сетки по умолчанию с одним столбцом на компонент в одной строке.

Since:

JDK1.1

GridLayout

public GridLayout(int rows,
                  int cols)

Параметры:

rows - строки, значение ноль означает любое количество строк.

cols - столбцы, значение ноль означает любое количество столбцов.

GridLayout

public GridLayout(int rows,
                  int cols,
                  int hgap,
                  int vgap)

Параметры:

rows - строки, значение ноль означает любое количество строк

cols - столбцы, значение ноль означает любое количество столбцов

hgap - горизонтальный отступ

vgap - вертикальный отступ

Исключения:

IllegalArgumentException - если значение обоих rows и cols установлено в ноль

Методы

getRows

public int getRows()

Возвращает количество строк в этом макете.

Возвращает:

количество строк в этом макете

Since:

JDK1.1

setRows

public void setRows(int rows)

Устанавливает количество строк в этом макете в указанное значение.

Параметры:

rows - количество строк в этом макете

Исключения:

IllegalArgumentException - если значение обоих rows и cols установлено в ноль

Since:

JDK1.1

getColumns

public int getColumns()

Возвращает количество столбцов в этом макете.

Возвращает:

количество столбцов в этом макете

Since:

JDK1.1

setColumns

public void setColumns(int cols)

Устанавливает количество столбцов в этом макете на указанное значение. Установка количества столбцов не оказывает влияния на макет, если количество строк, указанное конструктором или методом setRows, не равно нулю. В этом случае количество столбцов, отображаемых в макете, определяется общим числом компонентов и числом строк, указанных пользователем.

Параметры:

cols - количество столбцов в этом макете

Исключения:

IllegalArgumentException - если значение как rows, так и cols установлено в ноль

С:

JDK1.1

getHgap

public int getHgap()

Возвращает горизонтальный зазор между компонентами.

Возвращает:

горизонтальный зазор между компонентами

С:

JDK1.1

setHgap

public void setHgap(int hgap)

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

Параметры:

hgap - горизонтальный зазор между компонентами

С:

JDK1.1

getVgap

public int getVgap()

Возвращает вертикальный зазор между компонентами.

Возвращает:

вертикальный зазор между компонентами

С:

JDK1.1

setVgap

public void setVgap(int vgap)

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

Параметры:

vgap - вертикальный зазор между компонентами

С:

JDK1.1

addLayoutComponent

public void addLayoutComponent(String name,
                               Component comp)

Добавляет указанный компонент с указанным именем в макет.

Определено в:

addLayoutComponent в интерфейсе LayoutManager

Параметры:

name - имя компонента

comp - компонент, который нужно добавить

removeLayoutComponent

public void removeLayoutComponent(Component comp)

Удаляет указанный компонент из макета.

Определено в:

removeLayoutComponent в интерфейсе LayoutManager

Параметры:

comp - компонент, который нужно удалить

preferredLayoutSize

public Dimension preferredLayoutSize(Container parent)

Определено в:

preferredLayoutSize в интерфейсе LayoutManager

Параметры:

parent - контейнер, для которого выполняется размещение

Возвращает:

предпочтительные размеры для размещения подкомпонентов указанного контейнера

См. также:

minimumLayoutSize(java.awt.Container), Container.getPreferredSize()

minimumLayoutSize

public Dimension minimumLayoutSize(Container parent)

Определено в:

minimumLayoutSize в интерфейсе LayoutManager

Параметры:

parent - контейнер, для которого выполняется размещение

Возвращает:

минимальные размеры, необходимые для размещения подкомпонентов указанного контейнера

См. также:

preferredLayoutSize(java.awt.Container), Container.doLayout()

layoutContainer

public void layoutContainer(Container parent)

Определено в:

layoutContainer в интерфейсе LayoutManager

Параметры:

parent - контейнер, в котором будет выполнена компоновка

См. также:

Container, Container.doLayout()

toString

public String toString()

Возвращает строковое представление значений этой компоновки сетки.

Переопределяет:

toString в классе Object

Возвращает:

строковое представление этой компоновки сетки