Класс GroupLayout.Group

Прямые известные подклассы:
GroupLayout.ParallelGroup, GroupLayout.SequentialGroup
Вложенный класс:
GroupLayout
public abstract class GroupLayout.Group
extends Object

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.

C момента:
1.6
См. также:
GroupLayout.createSequentialGroup(), GroupLayout.createParallelGroup()

Методы

Модификатор и типМетодОписание
GroupLayout.GroupaddComponent​(Component component)

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

GroupLayout.GroupaddComponent​(Component component, int min, int pref, int max)

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

GroupLayout.GroupaddGap​(int size)

Добавляет жёсткий зазор к этому Group.

GroupLayout.GroupaddGap​(int min, int pref, int max)

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

GroupLayout.GroupaddGroup​(GroupLayout.Group group)

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

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

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

Методы

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, 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/javax/swing/GroupLayout.Group.html

Spec-Zone .ru
спецификации, руководства, описания, API