Класс SizeRequirements

java.lang.Object

javax.swing.SizeRequirements

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

public class SizeRequirements extends Object implements Serializable

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

tiled

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

aligned

Компоненты выравниваются в соответствии со значением выравнивания 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 со заданными минимальным, предпочтительным и максимальным размерами и указанным выравниванием.

Параметры:: 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 - выкладывать с увеличением смещений от 0, если true, и с уменьшением смещений от конца выделенного пространства, если false.
Since:: 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, то правую/нижнюю.
Since:: 1.4

adjustSizes

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

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

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

© 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/SizeRequirements.html