Spec-Zone.ru › OpenJDK 21

Класс GroupLayout.ParallelGroup

java.lang.Object
javax.swing.GroupLayout.Group
javax.swing.GroupLayout.ParallelGroup
Вложенный класс:
GroupLayout
public sealed class GroupLayout.ParallelGroup extends GroupLayout.Group
A Group, выравнивающий и задающий размеры своих дочерних элементов. ParallelGroup выравнивает свои дочерние элементы четырьмя возможными способами: по базовой линии, по центру, по ведущему краю или по хвостовому краю.

Базовая линия

A ParallelGroup, выравнивающий свои дочерние элементы по базовой линии, должен сначала определить, к чему привязана базовая линия. Базовая линия может быть привязана к верху или к низу группы. То есть, расстояние между базовой линией и началом группы может быть постоянным, или расстояние между концом группы и базовой линией может быть постоянным. Возможные варианты соответствуют BaselineResizeBehavior константам CONSTANT_ASCENT и CONSTANT_DESCENT.

Явное указание привязки базовой линии может быть задано методом createBaselineGroup, или определено на основе элементов. Если не указано явное значение, базовая линия будет привязана к низу, если все элементы с базовой линией и выравниванием по базовой линии имеют поведение изменения размера базовой линии CONSTANT_DESCENT; в противном случае базовая линия привязана к верху группы.

Элементы, выровненные по базовой линии, являются изменяемыми, если у них есть поведение изменения размера базовой линии CONSTANT_ASCENT или CONSTANT_DESCENT. Элементы с поведением изменения размера базовой линии OTHER или CENTER_OFFSET не изменяемы.

Базовая линия рассчитывается на основе предпочтительной высоты каждого элемента, имеющего базовую линию. Базовая линия рассчитывается по следующему алгоритму: max(maxNonBaselineHeight, maxAscent + maxDescent), где maxNonBaselineHeight - максимальная высота всех элементов, не имеющих базовой линии или не выровненных по базовой линии. maxAscent - максимальный подъем (базовая линия) всех элементов, имеющих базовую линию и выровненных по базовой линии. maxDescent - максимальный спуск (предпочтительная высота - базовая линия) всех элементов, имеющих базовую линию и выровненных по базовой линии.

A ParallelGroup, выравнивающий элементы по базовой линии, полезен только вдоль вертикальной оси. Если вы создадите группу по базовой линии и используете её вдоль горизонтальной оси, будет брошено IllegalStateException при запросе GroupLayout минимального, предпочтительного или максимального размера или попытке выложить компоненты.

Элементы, которые не выровнены по базовой линии и имеют размер меньше размера ParallelGroup, размещаются одним из трёх способов: по центру, по ведущему краю или по хвостовому краю.

Небазовая ParallelGroup

ParallelGroups, созданные с выравниванием, отличным от BASELINE, выравнивают элементы, которые меньше размера группы, одним из трёх способов: по центру, по ведущему краю или по хвостовому краю.

Ведущий край определяется осью и ComponentOrientation. Для вертикальной оси ведущим краем всегда является верхний край, а хвостовым - нижний. Когда ось ComponentOrientation равна LEFT_TO_RIGHT, ведущим краем является левый край, а хвостовым - правый. Значение ComponentOrientation равное RIGHT_TO_LEFT меняет местами левый и правый края. Дочерние элементы выравниваются в соответствии с указанным выравниванием при добавлении элемента. Если выравнивание не указано, используется выравнивание, заданное для ParallelGroup.

Чтобы выровнять элементы по базовой линии, createBaselineGroup, или createParallelGroup с выравниванием BASELINE. Если группа не была создана с выравниванием по базовой линии, и вы пытаетесь добавить элемент, указав выравнивание по базовой линии, будет брошено IllegalArgumentException.

Since:
1.6
См. также:
  • GroupLayout.createParallelGroup()
  • GroupLayout.createBaselineGroup(boolean,boolean)

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

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

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

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

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

addGroup

public GroupLayout.ParallelGroup addGroup(GroupLayout.Group group)
Добавляет Group в этот Group.
Переопределяет:
addGroup в классе GroupLayout.Group
Параметры:
group - добавляемый Group
Возвращает:
этот Group

addComponent

public GroupLayout.ParallelGroup addComponent(Component component)
Добавляет Component в этот Group.
Переопределяет:
addComponent в классе GroupLayout.Group
Параметры:
component - добавляемый Component
Возвращает:
этот Group

addComponent

public GroupLayout.ParallelGroup addComponent(Component component, int min, int pref, int max)
Добавляет Component в этот Group с указанным размером.
Переопределяет:
addComponent в классе GroupLayout.Group
Параметры:
component - добавляемый Component
min - минимальный размер или одно из значений DEFAULT_SIZE или PREFERRED_SIZE
pref - предпочтительный размер или одно из значений DEFAULT_SIZE или PREFERRED_SIZE
max - максимальный размер или одно из значений DEFAULT_SIZE или PREFERRED_SIZE
Возвращает:
этот Group

addGap

public GroupLayout.ParallelGroup addGap(int pref)
Добавляет жёсткий разрыв в этот Group.
Переопределяет:
addGap в классе GroupLayout.Group
Параметры:
pref - размер разрыва
Возвращает:
этот Group

addGap

public GroupLayout.ParallelGroup addGap(int min, int pref, int max)
Добавляет разрыв в этот Group с указанным размером.
Переопределяет:
addGap в классе GroupLayout.Group
Параметры:
min - минимальный размер разрыва
pref - предпочтительный размер разрыва
max - максимальный размер разрыва
Возвращает:
этот Group

addGroup

public GroupLayout.ParallelGroup addGroup(GroupLayout.Alignment alignment, GroupLayout.Group group)
Добавляет Group в этот ParallelGroup с указанным выравниванием. Если дочерний элемент меньше, чем Group, он выравнивается в соответствии с указанным выравниванием.
Параметры:
alignment - выравнивание
group - добавляемый Group
Возвращает:
этот ParallelGroup
Исключения:
IllegalArgumentException - если alignment является null

addComponent

public GroupLayout.ParallelGroup addComponent(Component component, GroupLayout.Alignment alignment)
Добавляет Component в этот ParallelGroup с указанным выравниванием.
Параметры:
component - добавляемый Component
alignment - выравнивание
Возвращает:
этот Group
Исключения:
IllegalArgumentException - если alignment является null

addComponent

public GroupLayout.ParallelGroup addComponent(Component component, GroupLayout.Alignment alignment, int min, int pref, int max)
Добавляет Component в этот ParallelGroup с указанным выравниванием и размером.
Параметры:
component - добавляемый Component
alignment - выравнивание
min - минимальный размер
pref - предпочтительный размер
max - максимальный размер
Возвращает:
этот Group
Исключения:
IllegalArgumentException - если alignment является null

© 1993, 2023, 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/21/docs/api/java.desktop/javax/swing/GroupLayout.ParallelGroup.html

Spec-Zone.ru

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