Класс GroupLayout.ParallelGroup
- Вложенный класс:
GroupLayout
public sealed class GroupLayout.ParallelGroup extends GroupLayout.Group
Group, выравнивающий и задающий размеры своих дочерних элементов. ParallelGroup выравнивает свои дочерние элементы четырьмя возможными способами: по базовой линии, по центру, по ведущему краю или по хвостовому краю. Базовая линия
AParallelGroup, выравнивающий свои дочерние элементы по базовой линии, должен сначала определить, к чему привязана базовая линия. Базовая линия может быть привязана к верху или к низу группы. То есть, расстояние между базовой линией и началом группы может быть постоянным, или расстояние между концом группы и базовой линией может быть постоянным. Возможные варианты соответствуют 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.ParallelGroup |
addComponent |
Добавляет Component к этому Group. |
GroupLayout.ParallelGroup |
addComponent |
Добавляет Component к этому Group с указанным размером. |
GroupLayout.ParallelGroup |
addComponent |
Добавляет Component к этому ParallelGroup с указанным выравниванием. |
GroupLayout.ParallelGroup |
addComponent |
Добавляет Component к этому ParallelGroup с указанным выравниванием и размером. |
GroupLayout.ParallelGroup |
addGap |
Добавляет жёсткий зазор к этому Group. |
GroupLayout.ParallelGroup |
addGap |
Добавляет зазор к этому Group с указанным размером. |
GroupLayout.ParallelGroup |
addGroup |
Добавляет Group к этому ParallelGroup с указанным выравниванием. |
GroupLayout.ParallelGroup |
addGroup |
Добавляет Group к этому Group. |
Подробное описание методов
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