Класс GroupLayout.Group
- java.lang.Object
-
- javax.swing.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.Group | addComponent(Component component) | Добавляет |
GroupLayout.Group | addComponent(Component component,
int min,
int pref,
int max) | Добавляет |
GroupLayout.Group | addGap(int size) | Добавляет жёсткий зазор к этому |
GroupLayout.Group | addGap(int min,
int pref,
int max) | Добавляет зазор к этому |
GroupLayout.Group | addGroup(GroupLayout.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