Класс GridLayout

java.lang.Object

java.awt.GridLayout

Все реализованные интерфейсы:: LayoutManager, Serializable

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.

Shows 6 buttons in rows of 2. Row 1 shows buttons 1 then 2.
Row 2 shows buttons 3 then 4. Row 3 shows buttons 5 then 6.

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

Shows 6 buttons in rows of 2. Row 1 shows buttons 2 then 1.
Row 2 shows buttons 4 then 3. Row 3 shows buttons 6 then 5.

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

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

С момента:

1.0

См. также:

Сериализованная форма

Краткое описание конструкторов

Конструктор	Описание
`GridLayout()`	Создаёт макет сетки с по умолчанию одним столбцом на компонент в одной строке.
`GridLayout(int rows, int cols)`	Создаёт макет сетки с указанным количеством строк и столбцов.
`GridLayout(int rows, int cols, int hgap, int vgap)`	Создаёт макет сетки с указанным количеством строк и столбцов.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`addLayoutComponent(String name, Component comp)`	Добавляет указанный компонент с указанным именем в макет.
`int`	`getColumns()`	Возвращает количество столбцов в этом макете.
`int`	`getHgap()`	Возвращает горизонтальный зазор между компонентами.
`int`	`getRows()`	Возвращает количество строк в этом макете.
`int`	`getVgap()`	Возвращает вертикальный зазор между компонентами.
`void`	`layoutContainer(Container parent)`	Выкладывает указанный контейнер с использованием этого макета.
`Dimension`	`minimumLayoutSize(Container parent)`	Определяет минимальный размер аргумента контейнера с использованием этого макета сетки.
`Dimension`	`preferredLayoutSize(Container parent)`	Определяет предпочтительный размер аргумента контейнера с использованием этого макета сетки.
`void`	`removeLayoutComponent(Component comp)`	Удаляет указанный компонент из макета.
`void`	`setColumns(int cols)`	Устанавливает количество столбцов в этом макете в указанное значение.
`void`	`setHgap(int hgap)`	Устанавливает горизонтальный зазор между компонентами в указанное значение.
`void`	`setRows(int rows)`	Устанавливает количество строк в этом макете в указанное значение.
`void`	`setVgap(int vgap)`	Устанавливает вертикальный зазор между компонентами в указанное значение.
`String`	`toString()`	Возвращает строковое представление значений этого макета сетки.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Подробное описание конструкторов

GridLayout

public GridLayout()

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

С момента:: 1.1

GridLayout

public GridLayout(int rows, int cols)

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

Одно, но не оба, из rows и cols может быть нулём, что означает, что любое количество объектов может быть размещено в строке или столбце.

Параметры:: rows - количество строк, значение нуль означает любое количество строк.; cols - количество столбцов, значение нуль означает любое количество столбцов.

GridLayout

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

Кроме того, горизонтальный и вертикальный отступы установлены в указанные значения. Горизонтальные отступы размещаются между каждым столбцом. Вертикальные отступы размещаются между каждой строкой.

Одно, но не оба, из rows и cols может быть нулём, что означает, что любое количество объектов может быть размещено в строке или в столбце.

Все GridLayout конструкторы обращаются к этому.

Параметры:: rows - количество строк, значение нуль означает любое количество строк; cols - количество столбцов, значение нуль означает любое количество столбцов; hgap - горизонтальный отступ; vgap - вертикальный отступ
Исключения:: IllegalArgumentException - если значение и rows и cols установлено в ноль

Подробное описание методов

getRows

public int getRows()

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

Возвращает:: количество строк в этом макете
С момента:: 1.1

setRows

public void setRows(int rows)

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

Параметры:: rows - количество строк в этом макете
Исключения:: IllegalArgumentException - если значение и rows и cols установлено в ноль
С момента:: 1.1

getColumns

public int getColumns()

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

Возвращает:: количество столбцов в этом макете
С момента:: 1.1

setColumns

public void setColumns(int cols)

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

Параметры:: cols - количество столбцов в этом макете
Исключения:: IllegalArgumentException - если значение и rows и cols установлено в ноль
С момента:: 1.1

getHgap

public int getHgap()

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

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

setHgap

public void setHgap(int hgap)

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

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

getVgap

public int getVgap()

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

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

setVgap

public void setVgap(int vgap)

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

Параметры:: vgap - вертикальный отступ между компонентами
С момента:: 1.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

public Dimension minimumLayoutSize(Container parent)

Определяет минимальный размер аргумента контейнера, используя этот макет сетки.

Минимальная ширина макета сетки - максимальная минимальная ширина всех компонентов в контейнере, умноженная на количество столбцов, плюс горизонтальный отступ, умноженный на количество столбцов минус один, плюс левые и правые отступы целевого контейнера.

Минимальная высота макета сетки - максимальная минимальная высота всех компонентов в контейнере, умноженная на количество строк, плюс вертикальный отступ, умноженный на количество строк минус один, плюс верхние и нижние отступы целевого контейнера.

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

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

Параметры:

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

Возвращает:

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

См. также:

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

layoutContainer

public void layoutContainer(Container parent)

Размечает указанный контейнер, используя этот макет.

Этот метод изменяет форму компонентов в указанном контейнере-мишени, чтобы удовлетворить ограничениям объекта GridLayout.

Менеджер макета сетки определяет размер отдельных компонентов, разделив свободное пространство в контейнере на равные части в соответствии с количеством строк и столбцов в макете. Свободное пространство контейнера равно размеру контейнера минус любые отступы и любой указанный горизонтальный или вертикальный отступ. Все компоненты в макете сетки имеют одинаковый размер.

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

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

Параметры:

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

См. также:

toString

public String toString()

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

Переопределяет:: toString в классе Object
Возвращает:: строковое представление этого макета сетки

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/java/awt/GridLayout.html