Класс SizeRequirements

java.lang.Object

javax.swing.SizeRequirements

Все реализуемые интерфейсы:: Serializable

public class SizeRequirements extends Object implements Serializable

Для удобства менеджеров компоновки вычисляет информацию о размерах и положении компонентов. Все методы вычисления размеров и положения являются методами класса, принимающими массивы SizeRequirements в качестве аргументов. Класс SizeRequirements поддерживает два типа компоновки:

мозаичная

Компоненты размещаются вплотную друг к другу, начиная либо с координаты 0 (крайняя левая или верхняя позиция), либо с координаты, соответствующей концу выделенного пространства (крайняя правая или нижняя позиция).

выровненная

Компоненты выравниваются в соответствии со значением выравнивания по X или Y каждого компонента.

Каждый объект SizeRequirements содержит информацию либо о ширине (и выравнивании по X), либо о высоте (и выравнивании по Y) отдельного компонента или группы компонентов:

minimum

Наименьшая допустимая ширина/высота компонента или группы компонентов в пикселях.

preferred

Естественная ширина/высота компонента или группы компонентов в пикселях.

maximum

Наибольшая допустимая ширина/высота компонента или группы компонентов в пикселях.

alignment

Выравнивание по X/Y компонента или группы компонентов.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими выпусками Swing. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями, использующими одну и ту же версию Swing. Начиная с версии 1.4 в пакете java.beans добавлена поддержка долговременного хранения всех JavaBeans. См. XMLEncoder.

Начиная с:

1.2

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`float`	`alignment`	Выравнивание, заданное значением от 0.0 до 1.0 включительно.
`int`	`maximum`	Максимально допустимый размер.
`int`	`minimum`	Минимально необходимый размер.
`int`	`preferred`	Предпочтительный (естественный) размер.

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

Конструктор	Описание
`SizeRequirements()`	Создает объект SizeRequirements с минимальным, предпочтительным и максимальным размерами, равными нулю, и значением выравнивания 0.5 (по центру).
`SizeRequirements(int min, int pref, int max, float a)`	Создает объект SizeRequirements с указанными минимальным, предпочтительным и максимальным размерами, а также заданным выравниванием.

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

Модификатор и тип	Метод	Описание
`static int[]`	`adjustSizes(int delta, SizeRequirements[] children)`	Корректирует заданный массив размеров на указанную величину.
`static void`	`calculateAlignedPositions(int allocated, SizeRequirements total, SizeRequirements[] children, int[] offsets, int[] spans)`	Создает набор пар смещения/интервала, задающих компоновку набора компонентов с указанными выравниваниями.
`static void`	`calculateAlignedPositions(int allocated, SizeRequirements total, SizeRequirements[] children, int[] offsets, int[] spans, boolean normal)`	Создает набор пар смещения/интервала, задающих компоновку набора компонентов с указанными выравниваниями.
`static void`	`calculateTiledPositions(int allocated, SizeRequirements total, SizeRequirements[] children, int[] offsets, int[] spans)`	Создает набор пар смещения/интервала, описывающих размещение набора компонентов вплотную друг к другу.
`static void`	`calculateTiledPositions(int allocated, SizeRequirements total, SizeRequirements[] children, int[] offsets, int[] spans, boolean forward)`	Создает набор пар смещения/интервала, описывающих размещение набора компонентов вплотную друг к другу.
`static SizeRequirements`	`getAlignedSizeRequirements(SizeRequirements[] children)`	Определяет общее пространство, необходимое для выравнивания набора компонентов.
`static SizeRequirements`	`getTiledSizeRequirements(SizeRequirements[] children)`	Определяет общее пространство, необходимое для размещения набора компонентов вплотную друг к другу.
`String`	`toString()`	Возвращает строку с описанием требований к минимальному, предпочтительному и максимальному размерам, а также выравнивания.

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

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

Подробное описание полей

minimum

public int minimum

Минимально необходимый размер. Для компонента comp он должен быть равен либо comp.getMinimumSize().width, либо comp.getMinimumSize().height.

preferred

public int preferred

Предпочтительный (естественный) размер. Для компонента comp он должен быть равен либо comp.getPreferredSize().width, либо comp.getPreferredSize().height.

maximum

public int maximum

Максимально допустимый размер. Для компонента comp он должен быть равен либо comp.getMaximumSize().width, либо comp.getMaximumSize().height.

alignment

public float alignment

Выравнивание, заданное значением от 0.0 до 1.0 включительно. Для центрирования значение выравнивания должно быть равно 0.5.

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

SizeRequirements

public SizeRequirements()

Создает объект SizeRequirements с минимальным, предпочтительным и максимальным размерами, равными нулю, и значением выравнивания 0.5 (по центру).

SizeRequirements

public SizeRequirements(int min, int pref, int max, float a)

Создает объект SizeRequirements с указанными минимальным, предпочтительным и максимальным размерами, а также заданным выравниванием.

Параметры:: min — минимальный размер >= 0; pref — предпочтительный размер >= 0; max — максимальный размер >= 0; a — выравнивание >= 0.0f && <= 1.0f

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

toString

public String toString()

Возвращает строку с описанием требований к минимальному, предпочтительному и максимальному размерам, а также выравнивания.

Переопределяет:: toString в классе Object
Возвращает:: строку

getTiledSizeRequirements

public static SizeRequirements getTiledSizeRequirements(SizeRequirements[] children)

Определяет общее пространство, необходимое для размещения набора компонентов вплотную друг к другу. Требования каждого компонента в наборе представлены элементом переданного массива SizeRequirements. Возвращаемый объект SizeRequirements имеет выравнивание 0.5 (по центру). Требуемое пространство не превышает Integer.MAX_VALUE.

Параметры:: children — требования к пространству для набора компонентов. Вектор может иметь нулевую длину; в этом случае будет возвращен экземпляр SizeRequirements со значениями по умолчанию.
Возвращает:: общие требования к пространству.

getAlignedSizeRequirements

public static SizeRequirements getAlignedSizeRequirements(SizeRequirements[] children)

Определяет общее пространство, необходимое для выравнивания набора компонентов. Требования каждого компонента в наборе представлены элементом переданного массива SizeRequirements. Общее требуемое пространство не превышает Integer.MAX_VALUE.

Параметры:: children — набор требований дочерних компонентов. Если он имеет нулевую длину, результатом будет экземпляр SizeRequirements со значениями по умолчанию.
Возвращает:: общие требования к пространству.

calculateTiledPositions

public static void calculateTiledPositions(int allocated, SizeRequirements total, SizeRequirements[] children, int[] offsets, int[] spans)

Параметры:: allocated — общий интервал для выделения >= 0.; total — сумма требований дочерних компонентов. Этот аргумент необязателен и может быть равен null.; children — требования к размерам каждого компонента.; offsets — смещение от 0 для каждого дочернего компонента, в пределах которого выделяются интервалы (определяет положение интервала).; spans — интервал, выделенный для каждого дочернего компонента, чтобы получить целевой общий интервал.

calculateTiledPositions

public static void calculateTiledPositions(int allocated, SizeRequirements total, SizeRequirements[] children, int[] offsets, int[] spans, boolean forward)

Создает набор пар смещения/интервала, описывающих размещение набора компонентов вплотную друг к другу. Этот метод требует указать общий объем выделяемого пространства, требования к размерам каждого размещаемого компонента (в виде массива SizeRequirements) и общие требования к размерам набора компонентов. Общие требования к размерам можно получить, вызвав метод getTiledSizeRequirements. Кроме того, этот метод требует указать флаг, определяющий, следует ли размещать компоненты в прямом направлении (смещения увеличиваются от 0) или в обратном направлении (смещения уменьшаются от конца выделенного пространства). Прямое направление соответствует размещению компонентов слева направо или сверху вниз. Обратное направление соответствует размещению компонентов справа налево или снизу вверх.

Параметры:: allocated — общий интервал для выделения >= 0.; total — сумма требований дочерних компонентов. Этот аргумент необязателен и может быть равен null.; children — требования к размерам каждого компонента.; offsets — смещение от 0 для каждого дочернего компонента, в пределах которого выделяются интервалы (определяет положение интервала).; spans — интервал, выделенный для каждого дочернего компонента, чтобы получить целевой общий интервал.; forward — если значение true, компоненты размещаются со смещениями, увеличивающимися от 0; если false — со смещениями, уменьшающимися от конца выделенного пространства.
Начиная с:: 1.4

calculateAlignedPositions

public static void calculateAlignedPositions(int allocated, SizeRequirements total, SizeRequirements[] children, int[] offsets, int[] spans)

Создает набор пар смещения/интервала, задающих компоновку набора компонентов с указанными выравниваниями. Выделенные интервалы будут перекрываться, причем каждый из них будет максимально точно вписан в заданное общее пространство. Этот метод требует указать общий объем выделяемого пространства, требования к размерам каждого размещаемого компонента (в виде массива SizeRequirements) и общие требования к размерам набора компонентов (фактически используется только поле выравнивания). Общие требования к размерам можно получить, вызвав метод getAlignedSizeRequirements. При обычном выравнивании значение 0.0f соответствует левому/верхнему краю компонента.

Параметры:: allocated — общий интервал для выделения >= 0.; total — сумма требований дочерних компонентов.; children — требования к размерам каждого компонента.; offsets — смещение от 0 для каждого дочернего компонента, в пределах которого выделяются интервалы (определяет положение интервала).; spans — интервал, выделенный для каждого дочернего компонента, чтобы получить целевой общий интервал.

calculateAlignedPositions

public static void calculateAlignedPositions(int allocated, SizeRequirements total, SizeRequirements[] children, int[] offsets, int[] spans, boolean normal)

Создает набор пар смещения/интервала, задающих компоновку набора компонентов с указанными выравниваниями. Выделенные интервалы будут перекрываться, причем каждый из них будет максимально точно вписан в заданное общее пространство. Этот метод требует указать общий объем выделяемого пространства, требования к размерам каждого размещаемого компонента (в виде массива SizeRequirements) и общие требования к размерам набора компонентов (фактически используется только поле выравнивания). Общие требования к размерам можно получить, вызвав метод getAlignedSizeRequirements. Кроме того, этот метод требует указать флаг, определяющий, следует ли выполнять обычное или обратное выравнивание. При обычном выравнивании значение 0.0f соответствует левому/верхнему краю выравниваемого компонента. При обратном выравнивании значение 0.0f соответствует правому/нижнему краю.

Параметры:: allocated — общий интервал для выделения >= 0.; total — сумма требований дочерних компонентов.; children — требования к размерам каждого компонента.; offsets — смещение от 0 для каждого дочернего компонента, в пределах которого выделяются интервалы (определяет положение интервала).; spans — интервал, выделенный для каждого дочернего компонента, чтобы получить целевой общий интервал.; normal — если значение true, выравнивание 0.0f означает левый/верхний край; если false — правый/нижний.
Начиная с:: 1.4

adjustSizes

public static int[] adjustSizes(int delta, SizeRequirements[] children)

Корректирует заданный массив размеров на указанную величину.

Параметры:: delta — целое число, задающее разницу размеров; children — массив объектов SizeRequirements
Возвращает:: массив целых чисел, содержащий итоговый размер каждого элемента

© 1993, 2025, 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/25/docs/api/java.desktop/javax/swing/SizeRequirements.html