Spec-Zone.ru › OpenJDK 25

Класс GridBagConstraints

java.lang.Object
java.awt.GridBagConstraints
Все реализованные интерфейсы:
Serializable, Cloneable
public class GridBagConstraints extends Object implements Cloneable, Serializable
Класс GridBagConstraints задает ограничения для компонентов, размещаемых с помощью класса GridBagLayout.
Начиная с версии:
1.0
См. также:
  • GridBagLayout
  • Сериализованная форма

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

Модификатор и тип Поле Описание
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()
Создает копию этого ограничения GridBag.

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

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

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

RELATIVE

public static final int RELATIVE
Указывает, что этот компонент является предпоследним компонентом в столбце или строке (gridwidth, gridheight) либо что этот компонент следует разместить рядом с компонентом, добавленным ранее (gridx, gridy).
См. также:
  • 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 должно быть неотрицательным значением.

См. также:
  • clone()
  • gridy
  • ComponentOrientation

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
Это поле используется, когда размер компонента меньше области его отображения. Оно определяет, где именно в области отображения разместить компонент.

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

См. также:
  • clone()
  • ComponentOrientation

fill

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

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

  • 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.
Начиная с:
1.2
См. также:
  • gridx
  • gridy
  • gridwidth
  • gridheight
  • weightx
  • weighty
  • anchor
  • fill
  • insets
  • ipadx
  • ipady

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

clone

public Object clone()
Создает копию этого ограничения GridBag.
Переопределяет:
clone в классе Object
Возвращает:
копию этого ограничения GridBag
См. также:
  • Cloneable

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, обзоры концепций, определения терминов, обходные решения и рабочие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторское право © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API