Класс GridBagConstraints
- java.lang.Object
-
- java.awt.GridBagConstraints
- Все реализованные интерфейсы:
-
Serializable,Cloneable
public class GridBagConstraints extends Object implements Cloneable, Serializable
Класс GridBagConstraints задаёт ограничения для компонентов, которые выложены с помощью класса GridBagLayout.
- С момента:
- 1.0
- См. также:
-
GridBagLayout, Сериализованная форма
Поля
| Модификатор и тип | Поле | Описание |
|---|---|---|
static int | ABOVE_BASELINE | Возможные значения для поля |
static int | ABOVE_BASELINE_LEADING | Возможные значения для поля |
static int | ABOVE_BASELINE_TRAILING | Возможные значения для поля |
int | anchor | Это поле используется, когда компонент меньше, чем его область отображения. |
static int | BASELINE | Возможные значения для поля |
static int | BASELINE_LEADING | Возможные значения для поля |
static int | BASELINE_TRAILING | Возможные значения для поля |
static int | BELOW_BASELINE | Возможные значения для поля |
static int | BELOW_BASELINE_LEADING | Возможные значения для поля |
static int | BELOW_BASELINE_TRAILING | Возможные значения для поля |
static int | BOTH | Изменение размера компонента по горизонтали и вертикали. |
static int | CENTER | Поместить компонент в центр его области отображения. |
static int | EAST | Поместить компонент справа от его области отображения, по центру по вертикали. |
int | fill | Это поле используется, когда область отображения компонента больше, чем запрошенный размер компонента. |
static int | FIRST_LINE_END | Поместить компонент в угол его области отображения, где обычно заканчивается первая строка текста на странице для текущего |
static int | FIRST_LINE_START | Поместить компонент в угол его области отображения, где обычно начинается первая строка текста на странице для текущего |
int | gridheight | Указывает количество ячеек в столбце для области отображения компонента. |
int | gridwidth | Указывает количество ячеек в строке для области отображения компонента. |
int | gridx | Указывает ячейку, содержащую ведущий край области отображения компонента, где первая ячейка в строке имеет |
int | gridy | Указывает ячейку вверху области отображения компонента, где верхняя ячейка имеет |
static int | HORIZONTAL | Изменить размер компонента по горизонтали, но не по вертикали. |
Insets | insets | Это поле указывает внешний отступ компонента, минимальное количество места между компонентом и краями его области отображения. |
int | ipadx | Это поле указывает внутренний отступ компонента, сколько места добавить к минимальной ширине компонента. |
int | ipady | Это поле указывает внутренний отступ, то есть сколько места добавить к минимальной высоте компонента. |
static int | LAST_LINE_END | Поместить компонент в угол его области отображения, где обычно заканчивается последняя строка текста на странице для текущего |
static int | LAST_LINE_START | Поместить компонент в угол его области отображения, где обычно начинается последняя строка текста на странице для текущего |
static int | LINE_END | Поместить компонент по центру вдоль края его области отображения, где строки текста обычно заканчиваются для текущего |
static int | LINE_START | Поместить компонент по центру вдоль края его области отображения, где строки текста обычно начинаются для текущего |
static int | NONE | Не изменять размер компонента. |
static int | NORTH | Поместить компонент в верхней части его области отображения, по центру по горизонтали. |
static int | NORTHEAST | Поместить компонент в верхнем правом углу его области отображения. |
static int | NORTHWEST | Поместить компонент в верхнем левом углу его области отображения. |
static int | PAGE_END | Поместить компонент по центру вдоль края его области отображения, связанной с концом страницы для текущего |
static int | PAGE_START | Поместить компонент по центру вдоль края его области отображения, связанной с началом страницы для текущего |
static int | RELATIVE | Указывает, что этот компонент является предпоследним в своём столбце или строке ( |
static int | REMAINDER | Указывает, что этот компонент является последним в своём столбце или строке. |
static int | SOUTH | Поместить компонент в нижней части его области отображения, по центру по горизонтали. |
static int | SOUTHEAST | Поместить компонент в нижнем правом углу его области отображения. |
static int | SOUTHWEST | Поместить компонент в нижнем левом углу его области отображения. |
static int | VERTICAL | Изменить размер компонента по вертикали, но не по горизонтали. |
double | weightx | Указывает, как распределять дополнительное горизонтальное пространство. |
double | weighty | Указывает, как распределять дополнительное вертикальное пространство. |
static int | WEST | Поместить компонент слева от его области отображения, по центру по вертикали. |
Конструкторы
| Конструктор | Описание |
|---|---|
GridBagConstraints() | Создаёт объект |
GridBagConstraints(int gridx,
int gridy,
int gridwidth,
int gridheight,
double weightx,
double weighty,
int anchor,
int fill,
Insets insets,
int ipadx,
int ipady) | Создаёт объект |
Методы
| Модификатор и тип | Метод | Описание |
|---|---|---|
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 для горизонтальной ориентации справа налево.
- См. также:
- Значения константных полей
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 должно быть неотрицательным значением.
gridwidth
public int gridwidth
Указывает количество ячеек в строке для области отображения компонента.
Используйте REMAINDER для указания того, что область отображения компонента будет от gridx до последней ячейки в строке. Используйте RELATIVE для указания того, что область отображения компонента будет от gridx до предпоследней ячейки в строке.
gridwidth должно быть неотрицательным, а значение по умолчанию равно 1.
- См. также:
-
clone(),gridheight
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.
- См. также:
-
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.
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
- См. также:
-
gridx,gridy,gridwidth,gridheight,weightx,weighty,anchor,fill,insets,ipadx,ipady
Методы
clone
public Object clone()
Создаёт копию этого ограничения сетки.
© 1993, 2020, 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/11/docs/api/java.desktop/java/awt/GridBagConstraints.html
