Класс GridBagConstraints

java.lang.Object

java.awt.GridBagConstraints

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

public class GridBagConstraints extends Object implements Cloneable, Serializable

Класс GridBagConstraints задает ограничения для компонентов, которые выложены с помощью класса GridBagLayout.

С тех пор:

1.0

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final int`	`ABOVE_BASELINE`	Возможные значения для поля `anchor`.
`static final int`	`ABOVE_BASELINE_LEADING`	Возможные значения для поля `anchor`.
`static final int`	`ABOVE_BASELINE_TRAILING`	Возможные значения для поля `anchor`.
`int`	`anchor`	Это поле используется, когда компонент меньше, чем его область отображения.
`static final int`	`BASELINE`	Возможные значения для поля `anchor`.
`static final int`	`BASELINE_LEADING`	Возможные значения для поля `anchor`.
`static final int`	`BASELINE_TRAILING`	Возможные значения для поля `anchor`.
`static final int`	`BELOW_BASELINE`	Возможные значения для поля `anchor`.
`static final int`	`BELOW_BASELINE_LEADING`	Возможные значения для поля `anchor`.
`static final int`	`BELOW_BASELINE_TRAILING`	Возможные значения для поля `anchor`.
`static final int`	`BOTH`	Изменить размер компонента как по горизонтали, так и по вертикали.
`static final int`	`CENTER`	Поместить компонент в центр его области отображения.
`static final int`	`EAST`	Поместить компонент справа от его области отображения, по центру по вертикали.
`int`	`fill`	Это поле используется, когда область отображения компонента больше, чем его запрашиваемый размер.
`static final int`	`FIRST_LINE_END`	Поместить компонент в угол его области отображения, где обычно заканчивается первая строка текста на странице для текущего `ComponentOrientation`.
`static final int`	`FIRST_LINE_START`	Поместить компонент в угол его области отображения, где обычно начинается первая строка текста на странице для текущего `ComponentOrientation`.
`int`	`gridheight`	Указывает количество ячеек в столбце для области отображения компонента.
`int`	`gridwidth`	Указывает количество ячеек в строке для области отображения компонента.
`int`	`gridx`	Указывает ячейку, содержащую ведущий край области отображения компонента, где первая ячейка в строке имеет `gridx=0`.
`int`	`gridy`	Указывает ячейку в верхней части области отображения компонента, где верхняя ячейка имеет `gridy=0`.
`static final int`	`HORIZONTAL`	Изменить размер компонента по горизонтали, но не по вертикали.
`Insets`	`insets`	Это поле указывает внешний отступ компонента, минимальное расстояние между компонентом и краями его области отображения.
`int`	`ipadx`	Это поле указывает внутренний отступ компонента, сколько места добавить к минимальной ширине компонента.
`int`	`ipady`	Это поле указывает внутренний отступ, то есть, сколько места добавить к минимальной высоте компонента.
`static final int`	`LAST_LINE_END`	Поместить компонент в угол его области отображения, где обычно заканчивается последняя строка текста на странице для текущего `ComponentOrientation`.
`static final int`	`LAST_LINE_START`	Поместить компонент в угол его области отображения, где обычно начинается последняя строка текста на странице для текущего `ComponentOrientation`.
`static final int`	`LINE_END`	Поместить компонент по центру вдоль края его области отображения, где строки текста обычно заканчиваются для текущего `ComponentOrientation`.
`static final int`	`LINE_START`	Поместить компонент по центру вдоль края его области отображения, где строки текста обычно начинаются для текущего `ComponentOrientation`.
`static final int`	`NONE`	Не изменять размер компонента.
`static final int`	`NORTH`	Поместить компонент вверху своей области отображения, по центру по горизонтали.
`static final int`	`NORTHEAST`	Поместить компонент в верхний правый угол его области отображения.
`static final int`	`NORTHWEST`	Поместить компонент в верхний левый угол его области отображения.
`static final int`	`PAGE_END`	Поместить компонент по центру вдоль края его области отображения, связанного с концом страницы для текущего `ComponentOrientation`.
`static final int`	`PAGE_START`	Поместить компонент по центру вдоль края его области отображения, связанного с началом страницы для текущего `ComponentOrientation`.
`static final int`	`RELATIVE`	Указывает, что этот компонент является предпоследним в своем столбце или строке (`gridwidth`, `gridheight`), или что этот компонент должен быть помещен рядом с ранее добавленным компонентом (`gridx`, `gridy`).
`static final int`	`REMAINDER`	Указывает, что этот компонент является последним в своем столбце или строке.
`static final int`	`SOUTH`	Поместить компонент внизу своей области отображения, по центру по горизонтали.
`static final int`	`SOUTHEAST`	Поместить компонент в нижний правый угол его области отображения.
`static final int`	`SOUTHWEST`	Поместить компонент в нижний левый угол его области отображения.
`static final int`	`VERTICAL`	Изменить размер компонента по вертикали, но не по горизонтали.
`double`	`weightx`	Указывает, как распределять дополнительное горизонтальное пространство.
`double`	`weighty`	Указывает, как распределять дополнительное вертикальное пространство.
`static final int`	`WEST`	Поместить компонент слева от его области отображения, по центру по вертикали.

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

Конструктор	Описание
`GridBagConstraints()`	Создает объект `GridBagConstraint` со всеми его полями, установленными по умолчанию.
`GridBagConstraints(int gridx, int gridy, int gridwidth, int gridheight, double weightx, double weighty, int anchor, int fill, Insets insets, int ipadx, int ipady)`	Создает объект `GridBagConstraints` со всеми его полями, установленными в соответствии с переданными аргументами.

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

Модификатор и тип	Метод	Описание
`Object`	`clone()`	Создает копию этой сетки ограничений.

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

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

Подробное описание полей

RELATIVE

public static final int RELATIVE

Указывает, что этот компонент является предпоследним компонентом в его столбце или строке (gridwidth, gridheight), или что этот компонент следует разместить рядом с ранее добавленным компонентом (gridx, gridy).

См. также:

REMAINDER

public static final int REMAINDER

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

См. также:

NONE

public static final int NONE

Не изменять размер компонента.

См. также:

BOTH

public static final int BOTH

Изменять размер компонента по горизонтали и вертикали.

См. также:

HORIZONTAL

public static final int HORIZONTAL

Изменять размер компонента по горизонтали, но не по вертикали.

См. также:

VERTICAL

public static final int VERTICAL

Изменять размер компонента по вертикали, но не по горизонтали.

См. также:

CENTER

public static final int CENTER

Разместить компонент по центру его области отображения.

См. также:

NORTH

public static final int NORTH

Разместить компонент в верхней части его области отображения, по центру по горизонтали.

См. также:

NORTHEAST

public static final int NORTHEAST

Разместить компонент в верхнем правом углу его области отображения.

См. также:

EAST

public static final int EAST

Разместить компонент справа от его области отображения, по центру по вертикали.

См. также:

SOUTHEAST

public static final int SOUTHEAST

Разместить компонент в нижнем правом углу его области отображения.

См. также:

SOUTH

public static final int SOUTH

Разместить компонент в нижней части его области отображения, по центру по горизонтали.

См. также:

SOUTHWEST

public static final int SOUTHWEST

Разместить компонент в нижнем левом углу его области отображения.

См. также:

WEST

public static final int WEST

Разместить компонент слева от его области отображения, по центру по вертикали.

См. также:

NORTHWEST

public static final int NORTHWEST

Разместить компонент в верхнем левом углу его области отображения.

См. также:

PAGE_START

public static final int PAGE_START

Разместить компонент по центру вдоль края его области отображения, связанного с началом страницы для текущего ComponentOrientation. Равно NORTH для горизонтальных ориентаций.

См. также:

PAGE_END

public static final int PAGE_END

Разместить компонент по центру вдоль края его области отображения, связанного с концом страницы для текущего ComponentOrientation. Равно SOUTH для горизонтальных ориентаций.

См. также:

LINE_START

public static final int LINE_START

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

См. также:

LINE_END

public static final int LINE_END

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

См. также:

FIRST_LINE_START

public static final int FIRST_LINE_START

Разместить компонент в углу его области отображения, где обычно начинается первая строка текста на странице для текущего ComponentOrientation. Равно NORTHWEST для горизонтальных, слева-направо ориентаций и NORTHEAST для горизонтальных, справа-налево ориентаций.

См. также:

FIRST_LINE_END

public static final int FIRST_LINE_END

Разместить компонент в углу его области отображения, где обычно заканчивается первая строка текста на странице для текущего ComponentOrientation. Равно NORTHEAST для горизонтальных, слева-направо ориентаций и NORTHWEST для горизонтальных, справа-налево ориентаций.

См. также:

LAST_LINE_START

public static final int LAST_LINE_START

Разместить компонент в углу его области отображения, где обычно начинается последняя строка текста на странице для текущего ComponentOrientation. Равно SOUTHWEST для горизонтальных, слева-направо ориентаций и SOUTHEAST для горизонтальных, справа-налево ориентаций.

См. также:

LAST_LINE_END

public static final int LAST_LINE_END

Разместить компонент в углу его области отображения, где обычно заканчивается последняя строка текста на странице для текущего ComponentOrientation. Равно SOUTHEAST для горизонтальных, слева-направо ориентаций и SOUTHWEST для горизонтальных, справа-налево ориентаций.

См. также:

БАЗОВАЯ ЛИНИЯ

public static final int BASELINE

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

С момента:

1.6

См. также:

BASELINE_LEADING

public static final int BASELINE_LEADING

Возможная величина для поля anchor. Указывает, что компонент должен быть размещен по ведущему краю по горизонтали. Для компонентов с ориентацией слева направо, ведущий край — это левый край. По вертикали компонент выровнен по базовой линии текущей строки. Если у компонента нет базовой линии, он будет центрирован по вертикали.

С момента:

1.6

См. также:

BASELINE_TRAILING

public static final int BASELINE_TRAILING

Возможная величина для поля anchor. Указывает, что компонент должен быть размещен по хвостовому краю по горизонтали. Для компонентов с ориентацией слева направо, хвостовой край — это правый край. По вертикали компонент выровнен по базовой линии текущей строки. Если у компонента нет базовой линии, он будет центрирован по вертикали.

С момента:

1.6

См. также:

ВЫШЕ БАЗОВОЙ ЛИНИИ

public static final int ABOVE_BASELINE

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

С момента:

1.6

См. также:

ВЫШЕ_БАЗОВОЙ_ЛИНИИ_ЛЕДЯЩИЙ

public static final int ABOVE_BASELINE_LEADING

Возможная величина для поля anchor. Указывает, что компонент должен быть размещен по ведущему краю по горизонтали. Для компонентов с ориентацией слева направо, ведущий край — это левый край. По вертикали компонент размещается так, что его нижний край касается базовой линии начальной строки. Если у начальной строки нет базовой линии, она будет центрирована по вертикали.

С момента:

1.6

См. также:

ВЫШЕ_БАЗОВОЙ_ЛИНИИ_ХВОСТОВОЙ

public static final int ABOVE_BASELINE_TRAILING

Возможная величина для поля anchor. Указывает, что компонент должен быть размещен по хвостовому краю по горизонтали. Для компонентов с ориентацией слева направо, хвостовой край — это правый край. По вертикали компонент размещается так, что его нижний край касается базовой линии начальной строки. Если у начальной строки нет базовой линии, она будет центрирована по вертикали.

С момента:

1.6

См. также:

НИЖЕ БАЗОВОЙ ЛИНИИ

public static final int BELOW_BASELINE

Возможная величина для поля anchor. Указывает, что компонент должен быть центрирован по горизонтали. По вертикали компонент размещается так, что его верхний край касается базовой линии начальной строки. Если у начальной строки нет базовой линии, она будет центрирована по вертикали.

С момента:

1.6

См. также:

НИЖЕ_БАЗОВОЙ_ЛИНИИ_ЛЕДЯЩИЙ

public static final int BELOW_BASELINE_LEADING

Возможная величина для поля anchor. Указывает, что компонент должен быть размещен по ведущему краю по горизонтали. Для компонентов с ориентацией слева направо, ведущий край — это левый край. По вертикали компонент размещается так, что его верхний край касается базовой линии начальной строки. Если у начальной строки нет базовой линии, она будет центрирована по вертикали.

С момента:

1.6

См. также:

НИЖЕ_БАЗОВОЙ_ЛИНИИ_ХВОСТОВОЙ

public static final int BELOW_BASELINE_TRAILING

Возможная величина для поля anchor. Указывает, что компонент должен быть размещен по хвостовому краю по горизонтали. Для компонентов с ориентацией слева направо, хвостовой край — это правый край. По вертикали компонент размещается так, что его верхний край касается базовой линии начальной строки. Если у начальной строки нет базовой линии, она будет центрирована по вертикали.

С момента:

1.6

См. также:

gridx

public int gridx

Указывает ячейку, содержащую ведущий край области отображения компонента, где первая ячейка в строке имеет gridx=0. Ведущий край области отображения компонента — это его левый край для горизонтального контейнера слева направо и его правый край для горизонтального контейнера справа налево. Значение RELATIVE указывает, что компонент должен быть помещен непосредственно после компонента, который был добавлен в контейнер перед добавлением этого компонента.

Значение по умолчанию — RELATIVE. gridx должно быть неотрицательным значением.

См. также:

gridy

public int gridy

Указывает ячейку вверху области отображения компонента, где верхняя ячейка имеет gridy=0. Значение RELATIVE указывает, что компонент должен быть помещен непосредственно под компонентом, который был добавлен в контейнер перед добавлением этого компонента.

Значение по умолчанию — RELATIVE. gridy должно быть неотрицательным значением.

См. также:

gridwidth

public int gridwidth

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

Используйте REMAINDER для указания того, что область отображения компонента будет от gridx до последней ячейки в строке. Используйте RELATIVE для указания того, что область отображения компонента будет от gridx до предпоследней ячейки в строке.

gridwidth должно быть неотрицательным, значение по умолчанию 1.

См. также:

gridheight

public int gridheight

Указывает количество ячеек в столбце для области отображения компонента.

Используйте REMAINDER для указания того, что область отображения компонента будет от gridy до последней ячейки в столбце. Используйте RELATIVE для указания того, что область отображения компонента будет от gridy до предпоследней ячейки в столбце.

gridheight должно быть неотрицательным, значение по умолчанию 1.

См. также:

weightx

public double weightx

Указывает, как распределять дополнительное горизонтальное пространство.

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

Если все веса равны нулю, все дополнительное пространство появляется между сетками ячейки и левым/правым краями.

Значение по умолчанию для этого поля — 0. weightx должно быть неотрицательным значением.

См. также:

weighty

public double weighty

Указывает, как распределять дополнительное вертикальное пространство.

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

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

Значение по умолчанию для этого поля — 0. weighty должно быть неотрицательным значением.

См. также:

anchor

public int anchor

Это поле используется, когда компонент меньше, чем его область отображения. Оно определяет, где внутри области отображения следует разместить компонент.

Существуют три типа возможных значений: относительные по ориентации, относительные по базовой линии и абсолютные. Значения, относительные по ориентации, интерпретируются относительно свойства ориентации компонента контейнера, значения, относительные к базовой линии, интерпретируются относительно базовой линии, а абсолютные — нет. Абсолютные значения: CENTER, NORTH, NORTHEAST, EAST, SOUTHEAST, SOUTH, SOUTHWEST, WEST, и NORTHWEST. Значения, относительные по ориентации: PAGE_START, PAGE_END, LINE_START, LINE_END, FIRST_LINE_START, FIRST_LINE_END, LAST_LINE_START и LAST_LINE_END. Значения, относительные к базовой линии: BASELINE, BASELINE_LEADING, BASELINE_TRAILING, ABOVE_BASELINE, ABOVE_BASELINE_LEADING, ABOVE_BASELINE_TRAILING, BELOW_BASELINE, BELOW_BASELINE_LEADING, и BELOW_BASELINE_TRAILING. Значение по умолчанию — CENTER.

См. также:

fill

public int fill

Это поле используется, когда область отображения компонента больше, чем запрошенный размер компонента. Оно определяет, нужно ли изменять размер компонента и, если нужно, как.

Для fill допустимы следующие значения:

NONE: Не изменять размер компонента.
HORIZONTAL: Увеличить ширину компонента до размера области отображения по горизонтали, но не изменять высоту.
VERTICAL: Увеличить высоту компонента до размера области отображения по вертикали, но не изменять ширину.
BOTH: Заполнить компонент полностью.

Значение по умолчанию — NONE.

См. также:

insets

public Insets insets

Это поле задаёт внешний отступ компонента, минимальное количество пространства между компонентом и краями его области отображения.

Значение по умолчанию — new Insets(0, 0, 0, 0).

См. также:

ipadx

public int ipadx

Это поле указывает внутренний отступ компонента, то есть, сколько пространства добавить к минимальной ширине компонента. Ширина компонента будет, по крайней мере, равна его минимальной ширине плюс ipadx пикселей.

Значение по умолчанию — 0.

См. также:

ipady

public int ipady

Это поле указывает внутренний отступ, то есть, сколько пространства добавить к минимальной высоте компонента. Высота компонента будет, по крайней мере, равна его минимальной высоте плюс ipady пикселей.

Значение по умолчанию — 0.

См. также:

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

GridBagConstraints

public GridBagConstraints()

Создаёт объект GridBagConstraint со всеми полями, установленными в значения по умолчанию.

GridBagConstraints

public GridBagConstraints(int gridx, int gridy, int gridwidth, int gridheight, double weightx, double weighty, int anchor, int fill, Insets insets, int ipadx, int ipady)

Создаёт объект GridBagConstraints со всеми полями, установленными в переданные аргументы. Примечание: из-за того, что использование этого конструктора затрудняет чтение исходного кода, этот конструктор следует использовать только инструментам автоматической генерации исходного кода.

Параметры:

gridx - Начальное значение gridx.

gridy - Начальное значение gridy.

gridwidth - Начальное значение gridwidth.

gridheight - Начальное значение gridheight.

weightx - Начальное значение weightx.

weighty - Начальное значение weighty.

anchor - Начальное значение anchor.

fill - Начальное значение fill.

insets - Начальное значение insets.

ipadx - Начальное значение ipadx.

ipady - Начальное значение ipady.

С:

1.2

См. также:

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

clone

public Object clone()

Создаёт копию этой настройки компоновки сетки.

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

clone в классе Object

Возвращает:

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

См. также:

© 1993, 2023, 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/21/docs/api/java.desktop/java/awt/GridBagConstraints.html