Класс LayoutStyle

java.lang.Object
- javax.swing.LayoutStyle

public abstract class LayoutStyle
extends Object

LayoutStyle предоставляет информацию о том, как позиционировать компоненты. Этот класс в первую очередь полезен для визуальных инструментов и менеджеров компоновки. Большинству разработчиков не потребуется использовать этот класс.

Обычно вы не устанавливаете и не создаёте LayoutStyle. Вместо этого используйте статический метод getInstance для получения текущего экземпляра.

Since:: 1.6

Вложенные классы

Модификатор и тип	Класс	Описание
`static class`	`LayoutStyle.ComponentPlacement`	`ComponentPlacement` — это перечисление возможных способов размещения двух компонентов относительно друг друга.

Конструкторы

Конструктор	Описание
`LayoutStyle()`	Создаёт новый `LayoutStyle`.

Методы

Модификатор и тип	Метод	Описание
`abstract int`	`getContainerGap(JComponent component, int position, Container parent)`	Возвращает количество места для размещения между компонентом и заданным краем его родителя.
`static LayoutStyle`	`getInstance()`	Возвращает общий экземпляр `LayoutStyle`.
`abstract int`	`getPreferredGap(JComponent component1, JComponent component2, LayoutStyle.ComponentPlacement type, int position, Container parent)`	Возвращает количество места для использования между двумя компонентами.
`static void`	`setInstance(LayoutStyle style)`	Устанавливает общий экземпляр `LayoutStyle`.

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

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

Конструкторы

LayoutStyle

public LayoutStyle()

Создаёт новый LayoutStyle. Обычно вы не создаёте LayoutStyle. Вместо этого используйте метод getInstance для получения текущего LayoutStyle.

Методы

setInstance

public static void setInstance(LayoutStyle style)

Устанавливает общий экземпляр LayoutStyle. Указание null приводит к использованию LayoutStyle из текущего LookAndFeel.

Parameters:: style — LayoutStyle, или null
See Also:: getInstance()

getInstance

public static LayoutStyle getInstance()

Возвращает общий экземпляр LayoutStyle. Если экземпляр не был указан в setInstance, это вернёт LayoutStyle из текущего LookAndFeel.

Returns:: общий экземпляр LayoutStyle
See Also:: LookAndFeel.getLayoutStyle()

getPreferredGap

public abstract int getPreferredGap(JComponent component1,
                                    JComponent component2,
                                    LayoutStyle.ComponentPlacement type,
                                    int position,
                                    Container parent)

Возвращает количество места для использования между двумя компонентами. Значение возврата указывает расстояние для размещения component2 относительно component1. Например, следующее возвращает количество места для размещения между component2 и component1, когда component2 размещён вертикально над component1:

int gap = getPreferredGap(component1, component2,
                             ComponentPlacement.RELATED,
                             SwingConstants.NORTH, parent);

Параметр type указывает отношение между двумя компонентами. Если два компонента будут содержаться в одном родителе и отображать похожие логически связанные элементы, используйте RELATED. Если два компонента будут содержаться в одном родителе, но отображать логически несвязанные элементы, используйте UNRELATED. Некоторые темы оформления могут не различать типы RELATED и UNRELATED.

Значение возврата не предназначено для учёта текущего размера и положения component2 или component1. Значение возврата может учитывать различные свойства компонентов. Например, расстояние может изменяться в зависимости от размера шрифта или предпочтительного размера компонента.

Parameters:: component1 — компонент JComponent, относительно которого размещается component2; component2 — компонент, который размещается; position — положение, относительно которого component2 размещается относительно component1; одно из SwingConstants.NORTH, SwingConstants.SOUTH, SwingConstants.EAST или SwingConstants.WEST; type — способ размещения двух компонентов; parent — родитель component2; это может отличаться от фактического родителя и может быть null
Returns:: количество места для размещения между двумя компонентами
Throws:: NullPointerException — если component1, component2 или type не null; IllegalArgumentException — если position не является одним из SwingConstants.NORTH, SwingConstants.SOUTH, SwingConstants.EAST или SwingConstants.WEST
Since:: 1.6
See Also:: LookAndFeel.getLayoutStyle()

getContainerGap

public abstract int getContainerGap(JComponent component,
                                    int position,
                                    Container parent)

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

Parameters:: component — позиционируемый компонент; position — положение, относительно которого компонент размещается относительно родителя; одно из SwingConstants.NORTH, SwingConstants.SOUTH, SwingConstants.EAST или SwingConstants.WEST; parent — родитель component; это может отличаться от фактического родителя и может быть null
Returns:: количество места для размещения между компонентом и заданным краем
Throws:: IllegalArgumentException — если position не является одним из SwingConstants.NORTH, SwingConstants.SOUTH, SwingConstants.EAST или SwingConstants.WEST