Класс 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 |
Создает объект GridBagConstraints, устанавливая для всех его полей переданные аргументы. |
Краткое описание методов
Подробное описание полей
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 должно быть неотрицательным значением.
- См. также:
gridwidth
public int gridwidth
Используйте REMAINDER, чтобы указать, что область отображения компонента будет простираться от gridx до последней ячейки строки. Используйте RELATIVE, чтобы указать, что область отображения компонента будет простираться от gridx до предпоследней ячейки строки.
gridwidth должно быть неотрицательным значением; значение по умолчанию — 1.
- См. также:
gridheight
public int gridheight
Используйте REMAINDER, чтобы указать, что область отображения компонента будет простираться от gridy до последней ячейки столбца. Используйте RELATIVE, чтобы указать, что область отображения компонента будет простираться от gridy до предпоследней ячейки столбца.
gridheight должно быть неотрицательным значением; значение по умолчанию — 1.
- См. также:
weightx
public double weightx
Менеджер компоновки grid bag вычисляет вес столбца как максимальное значение weightx всех компонентов в столбце. Если итоговая компоновка по горизонтали меньше области, которую необходимо заполнить, дополнительное пространство распределяется между столбцами пропорционально их весу. Столбец с нулевым весом не получает дополнительного пространства.
Если все веса равны нулю, всё дополнительное пространство появляется между сетками ячеек и левым и правым краями.
Значение этого поля по умолчанию — 0. weightx должно быть неотрицательным значением.
- См. также:
weighty
public double weighty
Менеджер компоновки grid bag вычисляет вес строки как максимальное значение 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
© 1993, 2025, 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/25/docs/api/java.desktop/java/awt/GridBagConstraints.html