Класс GroupLayout.Group

java.lang.Object

javax.swing.GroupLayout.Group

Известные прямые подклассы:: GroupLayout.ParallelGroup, GroupLayout.SequentialGroup

Внешний класс:: GroupLayout

public abstract sealed class GroupLayout.Group extends Object permits GroupLayout.ParallelGroup, GroupLayout.SequentialGroup

Group предоставляет основу для двух типов операций, поддерживаемых GroupLayout: размещения компонентов последовательно друг за другом (SequentialGroup) или с выравниванием (ParallelGroup). Group и его подклассы не имеют общедоступного конструктора; для создания объекта используйте один из createSequentialGroup или createParallelGroup. Кроме того, использование Group, созданного одним GroupLayout, с другим приведет к неопределенным результатам.

Различные методы в Group и его подклассах позволяют явно задавать диапазон. Аргументы этих методов могут иметь одну из двух форм: значение, большее или равное 0, либо одно из DEFAULT_SIZE или PREFERRED_SIZE. Значение, большее или равное 0, указывает конкретный размер. DEFAULT_SIZE указывает, что следует использовать соответствующий размер компонента. Например, если DEFAULT_SIZE передается в качестве минимального размера, минимальный размер определяется вызовом getMinimumSize для компонента. Аналогично, PREFERRED_SIZE указывает, что следует использовать значение из getPreferredSize. В следующем примере myComponent добавляется в group с конкретными значениями диапазона. Иными словами, минимальный размер явно задан равным 100, предпочтительный — 200, а максимальный — 300.

  group.addComponent(myComponent, 100, 200, 300);

В следующем примере myComponent добавляется в group с использованием сочетания этих форм. Минимальный размер принудительно устанавливается равным предпочтительному, предпочтительный размер определяется с помощью myComponent.getPreferredSize, а максимальный — вызовом getMaximumSize для компонента.

  group.addComponent(myComponent, GroupLayout.PREFERRED_SIZE,
            GroupLayout.PREFERRED_SIZE, GroupLayout.DEFAULT_SIZE);

Если не указано иное, все методы Group и его подклассов, позволяющие задавать диапазон, выбрасывают IllegalArgumentException, если им передан недопустимый диапазон. Диапазон недопустим, если какое-либо из значений меньше 0 и не является одним из PREFERRED_SIZE или DEFAULT_SIZE, либо если для конкретных значений не выполняется следующее условие: min <= pref <= max.

Аналогично, любые методы, принимающие Component, выбрасывают IllegalArgumentException, если им передан null, а любые методы, принимающие Group, выбрасывают NullPointerException, если им передан null.

Начиная с:

1.6

См. также:

Краткое описание методов

Модификатор и тип	Метод	Описание
`GroupLayout.Group`	`addComponent(Component component)`	Добавляет `Component` в эту `Group`.
`GroupLayout.Group`	`addComponent(Component component, int min, int pref, int max)`	Добавляет `Component` в эту `Group` с указанным размером.
`GroupLayout.Group`	`addGap(int size)`	Добавляет фиксированный промежуток в эту `Group`.
`GroupLayout.Group`	`addGap(int min, int pref, int max)`	Добавляет промежуток в эту `Group` с указанным размером.
`GroupLayout.Group`	`addGroup(GroupLayout.Group group)`	Добавляет `Group` в эту `Group`.

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

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`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, либо до истечения заданного промежутка реального времени.

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

addGroup

public GroupLayout.Group addGroup(GroupLayout.Group group)

Добавляет Group в эту Group.

Параметры:: group — Group для добавления
Возвращает:: эта Group

addComponent

public GroupLayout.Group addComponent(Component component)

Добавляет Component в эту Group.

Параметры:: component — Component для добавления
Возвращает:: эта Group

addComponent

public GroupLayout.Group addComponent(Component component, int min, int pref, int max)

Добавляет Component в эту Group с указанным размером.

Параметры:: component — Component для добавления; min — минимальный размер либо одно из значений DEFAULT_SIZE или PREFERRED_SIZE; pref — предпочтительный размер либо одно из значений DEFAULT_SIZE или PREFERRED_SIZE; max — максимальный размер либо одно из значений DEFAULT_SIZE или PREFERRED_SIZE
Возвращает:: эта Group

addGap

public GroupLayout.Group addGap(int size)

Добавляет фиксированный промежуток в эту Group.

Параметры:: size — размер промежутка
Возвращает:: эта Group
Исключения:: IllegalArgumentException — если size меньше 0

addGap

public GroupLayout.Group addGap(int min, int pref, int max)

Добавляет промежуток в эту Group с указанным размером.

Параметры:: min — минимальный размер промежутка; pref — предпочтительный размер промежутка; max — максимальный размер промежутка
Возвращает:: эта Group
Исключения:: IllegalArgumentException — если какое-либо из значений меньше 0

© 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.