Класс 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, поддержка долгосрочного хранения всех JavaBeans была добавлена в пакет java.beans. Пожалуйста, обратитесь к 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()`	Возвращает строку, описывающую минимальный, предпочтительный и максимальный размеры, а также выравнивание.

Методы, объявленные в классе java.lang.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 с заданными минимальным, предпочтительным и максимальным размерами и заданным выравниванием.

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

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

toString

public String toString()

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

Overrides:: toString в классе Object
Returns:: строка

getTiledSizeRequirements

public static SizeRequirements getTiledSizeRequirements(SizeRequirements[] children)

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

Parameters:: children - требования к пространству для набора компонентов. Вектор может иметь нулевую длину, что приведёт к возвращению экземпляра объекта SizeRequirements по умолчанию.
Returns:: общие требования к пространству.

getAlignedSizeRequirements

public static SizeRequirements getAlignedSizeRequirements(SizeRequirements[] children)

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

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

calculateTiledPositions

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

Parameters:: 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) или в обратном направлении (смещения убывают от конца выделенного пространства). Прямое направление представляет компоненты, выложенные слева направо или сверху вниз. Обратное направление представляет компоненты, выложенные справа налево или снизу вверх.

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

calculateAlignedPositions

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

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

Parameters:: 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 соответствует правой/нижней границе.

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

adjustSizes

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

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

Parameters:: delta - целое число, определяющее разницу размеров; children - массив объектов SizeRequirements
Returns:: массив целых чисел, содержащий окончательный размер для каждого элемента

© 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/SizeRequirements.html