Spec-Zone.ru › OpenJDK 27

Класс 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()
Создаёт объект GridBagConstraints, устанавливая все его поля в значения по умолчанию.
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
Модификатор и тип Метод Описание
boolean equals(Object obj)
Указывает, равен ли другой объект этому объекту.
protected void finalize()
Устарело, подлежит удалению: этот элемент API может быть удалён в будущей версии.
Финализация устарела и будет удалена в одном из будущих выпусков.
final Class<?> getClass()
Возвращает класс времени выполнения этого Object.
int hashCode()
Возвращает хеш-код этого объекта.
final void notify()
Пробуждает один поток, ожидающий на мониторе этого объекта.
final void notifyAll()
Пробуждает все потоки, ожидающие на мониторе этого объекта.
String toString()
Возвращает строковое представление объекта.
final void wait()
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
final void wait(long timeoutMillis)
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.
final void wait(long timeoutMillis, int nanos)
Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного интервала реального времени.

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

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

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

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

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

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

weighty

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

Менеджер компоновки GridBag вычисляет вес строки как максимальное значение 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()
Создаёт объект GridBagConstraints, устанавливая для всех его полей значения по умолчанию.

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()
Создает копию этого ограничения сетки.
Переопределяет:
clone в классе Object
Возвращает:
копию этого ограничения сетки
См. также:
  • Cloneable

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в разделе Документация Java SE, где приведены более подробные описания для разработчиков, концептуальные обзоры, определения терминов, обходные решения и работающие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторские права © 1993, 2026, 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.

Spec-Zone.ru

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