Spec-Zone.ru › OpenJDK 24

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

Методы, объявленные в классе java.lang.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 для горизонтальных, справа-налево ориентаций.
См. также:
  • Значения константных полей

НАЧАЛО_ПОСЛЕДНЕЙ_СТРОКИ

public static final int LAST_LINE_START
Разместите компонент в углу его области отображения, где обычно начинается последняя строка текста на странице для текущего ComponentOrientation. Равно SOUTHWEST для горизонтальной ориентации слева направо и SOUTHEAST для горизонтальной ориентации справа налево.
См. также:
  • Значения константных полей

КОНЕЦ_ПОСЛЕДНЕЙ_СТРОКИ

public static final int LAST_LINE_END
Разместите компонент в углу его области отображения, где обычно заканчивается последняя строка текста на странице для текущего ComponentOrientation. Равно SOUTHEAST для горизонтальной ориентации слева направо и SOUTHWEST для горизонтальной ориентации справа налево.
См. также:
  • Значения константных полей

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

public static final int BASELINE
Возможная величина для поля anchor. Указывает, что компонент должен быть по горизонтали центрирован и по вертикали выровнен по базовой линии текущей строки. Если у компонента нет базовой линии, он будет центрирован по вертикали.
С:
1.6
См. также:
  • Значения константных полей

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

public static final int BASELINE_LEADING
Возможная величина для поля anchor. Указывает, что компонент должен быть расположен по горизонтали вдоль левого края. Для компонентов с ориентацией слева направо левый край — это левый край. По вертикали компонент выравнивается по базовой линии текущей строки. Если у компонента нет базовой линии, он будет центрирован по вертикали.
С:
1.6
См. также:
  • Значения константных полей

БАЗОВАЯ_ЛИНИЯ_ВПРАВО

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

См. также:
  • 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 не получает дополнительного пространства.

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

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

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

weighty

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

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

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

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

© 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/GridBagConstraints.html

Spec-Zone.ru

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