Класс 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 для горизонтальных, справа налево ориентаций.

См. также:

Значения постоянных полей

BASELINE

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

См. также:

Значения постоянных полей

ABOVE_BASELINE

public static final int ABOVE_BASELINE

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

С тех пор:

1.6

См. также:

Значения постоянных полей

ABOVE_BASELINE_LEADING

public static final int ABOVE_BASELINE_LEADING

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

С тех пор:

1.6

См. также:

Значения постоянных полей

ABOVE_BASELINE_TRAILING

public static final int ABOVE_BASELINE_TRAILING

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

С тех пор:

1.6

См. также:

Значения постоянных полей

BELOW_BASELINE

public static final int BELOW_BASELINE

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

С тех пор:

1.6

См. также:

Значения постоянных полей

BELOW_BASELINE_LEADING

public static final int BELOW_BASELINE_LEADING

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

С тех пор:

1.6

См. также:

Значения постоянных полей

BELOW_BASELINE_TRAILING

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 должно быть неотрицательным значением.

См. также:

clone()
gridx

gridwidth

public int gridwidth

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

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

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

См. также:

clone()
gridheight

gridheight

public int gridheight

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

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

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

См. также:

clone()
gridwidth

weightx

public double weightx

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

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

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

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

См. также:

clone()
weighty

weighty

public double weighty

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

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

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

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

См. также:

clone()
weightx

anchor

public int anchor

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

Существуют три типа возможных значений: относительные к ориентации, относительные к базовой линии и абсолютные. Значения, относительные к ориентации, интерпретируются относительно свойства ориентации контейнера, значения, относительные к базовой линии, интерпретируются относительно базовой линии, а абсолютные — нет. Абсолютные значения: 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

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

Следующие значения допустимы для %%%CODE_BLOCK_253%%:

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

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

См. также:

clone()

insets

public Insets insets

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

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

См. также:

clone()

ipadx

public int ipadx

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

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

См. также:

clone()
ipady

ipady

public int ipady

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

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

См. также:

clone()
ipadx

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

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.

Since:

1.2

См. также:

gridx
gridy
gridwidth
gridheight
weightx
weighty
anchor
fill
insets
ipadx
ipady

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

clone

public Object clone()

Создает копию этой сетки ограничений.

Overrides:

clone в классе Object

Возвращает:

копию этой сетки ограничений

См. также:

Cloneable

© 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/GridBagConstraints.html