Spec-Zone.ru › OpenJDK 17

Класс 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.

С:
1.6
См. также:
  • GroupLayout.createSequentialGroup()
  • GroupLayout.createParallelGroup()

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

Модификатор и тип Метод Описание
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.

Методы, унаследованные от класса 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, 2021, 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/17/docs/api/java.desktop/javax/swing/GroupLayout.Group.html

Spec-Zone.ru

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