Package swingtree.api

Interface Layout

All Known Implementing Classes:

Layout.BorderLayoutInstaller, Layout.ForBoxLayout, Layout.ForFlowLayout, Layout.ForGridLayout, Layout.ForMigLayout, Layout.None, Layout.Unspecific

@Immutable
public interface Layout

An abstract representation of an immutable layout configuration for a specific component, for which layout manager specific implementations can be instantiated through various factory methods like border(), flow(), grid(int, int)... and then supplied to the style API through ComponentStyleDelegate.layout(Layout) so that the layout can then be installed onto a component dynamically.

The various layout types hold necessary information and implementation logic required for installing the layout onto a component through the installFor(JComponent) method, which will be used by the style engine of SwingTree every time the layout object state changes compared to the previous state effectively making the layout mechanics of a component fully dynamic.

You may implement this interface to create custom layout configurations for other kinds of LayoutManager implementations.

This interface also contains various implementations for supporting the most common types of LayoutManagers.

See Also:

• For a common practical usecase, see this method.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	Layout.BorderLayoutInstaller	The Layout.BorderLayoutInstaller layout is a layout that represents a BorderLayout layout configuration for a component, which consists of the horizontal gap and vertical gap.
static final class	Layout.ForBoxLayout	The Layout.ForBoxLayout layout is a layout that represents a BoxLayout layout configuration for a component, which consists of the axis.
static final class	Layout.ForFlowLayout	An immutable Layout implementation that configures and installs a ResponsiveGridFlowLayout onto a component.
static final class	Layout.ForGridLayout	A Layout which installs a UniformGridLayout onto a component, created through one of the grid(int, int) factory methods.
static final class	Layout.ForMigLayout	An immutable Layout implementation that configures and installs a MigLayout onto a component.
static final class	Layout.None	The Layout.None layout removes any existing LayoutManager from a component (sets it to null), enabling fully manual positioning of child components via Component.setBounds(int, int, int, int).
static final class	Layout.Unspecific	The Layout.Unspecific layout is a layout that represents the lack of a specific layout being set for a component.

Method Summary

Modifier and Type	Method	Description
static Layout	border()	A factory method for creating a layout that installs the BorderLayout onto a component based on the supplied parameters.
static Layout	border(int horizontalGap, int verticalGap)	A factory method for creating a layout that installs the BorderLayout onto a component based on the supplied parameters.
static Layout	box()	A factory method for creating a layout that installs the BoxLayout onto a component with a default axis of UI.Axis.HORIZONTAL.
static Layout	box(UI.Axis axis)	A factory method for creating a layout that installs the BoxLayout onto a component based on the supplied UI.Axis parameter.
boolean	equals(Object o)
static Layout.ForFlowLayout	flow()	A factory method for creating a Layout.ForFlowLayout configuration that installs a ResponsiveGridFlowLayout with centered alignment and default gaps of 5 pixels.
static Layout.ForFlowLayout	flow(FlowCell... childConstraints)	A convenience factory method that creates a centered Layout.ForFlowLayout pre-loaded with per-child FlowCell constraints.
static Layout.ForFlowLayout	flow(UI.HorizontalAlignment align)	A factory method for creating a Layout.ForFlowLayout configuration that installs a ResponsiveGridFlowLayout with the given alignment and default gaps of 5 pixels.
static Layout.ForFlowLayout	flow(UI.HorizontalAlignment align, int hgap, int vgap)	A factory method for creating a Layout.ForFlowLayout configuration that installs a ResponsiveGridFlowLayout onto a component with the given alignment and gaps.
static Layout.ForFlowLayout	flow(UI.HorizontalAlignment align, FlowCell... childConstraints)	A convenience factory method that creates a Layout.ForFlowLayout with the given alignment and per-child FlowCell constraints pre-loaded.
static Layout.ForGridLayout	grid(int rows, int cols)	A factory method for a Layout.ForGridLayout which installs a UniformGridLayout with the given numbers of rows and columns and no gaps onto a component.
static Layout.ForGridLayout	grid(int rows, int cols, int horizontalGap, int verticalGap)	A factory method for a Layout.ForGridLayout which installs a UniformGridLayout with the given numbers of rows and columns and the given gaps onto a component.
static Layout.ForGridLayout	grid(UniformGridLayout.Mode mode, UniformGridLayout.CollapseEmpty collapseEmpty, int rows, int cols)	A factory method for a Layout.ForGridLayout which installs a UniformGridLayout with the given settings and numbers of rows and columns, and no gaps, onto a component.
static Layout.ForGridLayout	grid(UniformGridLayout.Mode mode, UniformGridLayout.CollapseEmpty collapseEmpty, int rows, int cols, int horizontalGap, int verticalGap)	A factory method for a Layout.ForGridLayout which installs a UniformGridLayout with the given settings, numbers of rows and columns and gaps onto a component.
static Layout.ForGridLayout	grid(UniformGridLayout.Mode mode, UniformGridLayout.CollapseEmpty collapseEmpty, UniformGridLayout.OverflowGrowth overflowGrowth, int rows, int cols)	A factory method for a Layout.ForGridLayout which installs a UniformGridLayout with every one of its settings and the given numbers of rows and columns, and no gaps, onto a component.
static Layout.ForGridLayout	grid(UniformGridLayout.Mode mode, UniformGridLayout.CollapseEmpty collapseEmpty, UniformGridLayout.OverflowGrowth overflowGrowth, int rows, int cols, int horizontalGap, int verticalGap)	A factory method for a Layout.ForGridLayout which installs a UniformGridLayout with every one of its settings, the given numbers of rows and columns and the given gaps onto a component.
int	hashCode()
void	installFor(JComponent component)	Installs this layout for the supplied component.
static Layout.ForMigLayout	mig(String constr)	A convenience overload of mig(LayoutConstraint) that accepts a plain constraint string instead of a LayoutConstraint object.
static Layout.ForMigLayout	mig(String constr, String rowConstr)	A convenience overload of mig(LayoutConstraint, LayoutConstraint) that accepts plain constraint strings instead of LayoutConstraint objects.
static Layout.ForMigLayout	mig(String constr, String colConstr, String rowConstr)	A convenience overload of mig(LayoutConstraint, LayoutConstraint, LayoutConstraint) that accepts plain constraint strings instead of LayoutConstraint objects.
static Layout.ForMigLayout	mig(String constr, MigAddConstraint... childConstraints)	A convenience factory method that creates a MigLayout-based layout configuration from a plain constraint string together with per-child MigAddConstraints for the component's direct children.
static Layout.ForMigLayout	mig(LayoutConstraint constr)	A factory method for creating a MigLayout-based layout configuration from a single type-safe LayoutConstraint, with no column or row constraints.
static Layout.ForMigLayout	mig(LayoutConstraint constr, LayoutConstraint rowConstr)	A factory method for creating a MigLayout-based layout configuration from type-safe LayoutConstraint objects, without column constraints.
static Layout.ForMigLayout	mig(LayoutConstraint constr, LayoutConstraint colConstr, LayoutConstraint rowConstr)	The preferred factory method for creating a MigLayout-based layout configuration from type-safe LayoutConstraint objects.
static Layout.ForMigLayout	mig(LayoutConstraint constr, MigAddConstraint... childConstraints)	A convenience factory method that creates a MigLayout-based layout configuration from a single type-safe LayoutConstraint together with per-child MigAddConstraints for the component's direct children.
static Layout.None	none()	Returns a Layout.None layout that removes any existing LayoutManager from a component (sets it to null), enabling manual positioning of child components via their Component.setBounds(int, int, int, int) method.
static Layout.None	none(Bounds... childBounds)	A convenience factory that creates a Layout.None layout pre-loaded with per-child Bounds.
static Layout	unspecific()	A factory method for creating a layout that does nothing (i.e.

Method Details

hashCode

int hashCode()

Overrides:

hashCode in class Object

Returns:

A hash code value for this layout.

equals

boolean equals(Object o)

Overrides:

equals in class Object

Parameters:

o - The object to compare this layout to.

Returns:

true if the supplied object is a layout that is equal to this layout, false otherwise.

installFor

void installFor(JComponent component)

Installs this layout for the supplied component.

Parameters:

component - The component to install this layout for.

unspecific

static Layout unspecific()

A factory method for creating a layout that does nothing (i.e. it does not install any layout for a component). This is a no-op layout that can be used to represent the lack of a specific layout being set for a component without having to set the layout to null.

Returns:

A layout that does nothing, i.e. it does not install any layout for a component.

none

static Layout.None none()

Returns a Layout.None layout that removes any existing LayoutManager from a component (sets it to null), enabling manual positioning of child components via their Component.setBounds(int, int, int, int) method.

To also specify the initial bounds of child components declaratively, chain Layout.None.withChildBounds(Bounds...) on the returned instance, or use the none(Bounds...) shorthand factory.

Returns:

A Layout.None layout that removes any existing layout manager from a component.

none

static Layout.None none(Bounds... childBounds)

A convenience factory that creates a Layout.None layout pre-loaded with per-child Bounds. This is a shorthand for:

      Layout.none().withChildBounds(childBounds)
  

When installFor is called, the layout manager is first removed from the component (enabling absolute positioning), and then each supplied Bounds entry is applied to the corresponding child by index via Component.setBounds(int, int, int, int). Because the underlying storage is a sparse Association, you only need to supply bounds for the children you actually want to position; children without an entry are left untouched.

Parameters:

childBounds - The Bounds to apply to the component's children, in child-index order.

Returns:

A Layout.None layout that removes any layout manager and applies the given bounds to the corresponding children.

mig

static Layout.ForMigLayout mig(LayoutConstraint constr,
 LayoutConstraint colConstr,
 LayoutConstraint rowConstr)

The preferred factory method for creating a MigLayout-based layout configuration from type-safe LayoutConstraint objects.

LayoutConstraint is a composable, type-safe wrapper around MigLayout constraint strings. The recommended way to use it is through the constants and factory methods available via import static swingtree.UI.*, which can then be combined with LayoutConstraint.and(LayoutConstraint):

      import static swingtree.UI.*;
      // ...
      Layout.mig( FILL.and(WRAP(2)), "[shrink][grow]", "[]8[]" )
  

Using LayoutConstraint instead of raw strings catches typos at call-site and makes constraint composition explicit and refactor-friendly. See the MigLayout whitepaper for full constraint documentation.

The returned Layout.ForMigLayout instance supports fluent chaining to specify per-child component constraints via the various Layout.ForMigLayout.withChildConstraints(MigAddConstraint...) overloads.

Parameters:

constr - The general layout constraints for the MigLayout (e.g. FILL.and(WRAP(2))).

colConstr - The column constraints for the MigLayout (e.g. LayoutConstraint.of("[shrink][grow]")).

rowConstr - The row constraints for the MigLayout (e.g. LayoutConstraint.of("[]8[]")).

Returns:

A Layout.ForMigLayout configured with the supplied constraints.

mig

static Layout.ForMigLayout mig(LayoutConstraint constr,
 LayoutConstraint rowConstr)

A factory method for creating a MigLayout-based layout configuration from type-safe LayoutConstraint objects, without column constraints. This is the preferred approach over the plain-String overloads.

See mig(LayoutConstraint, LayoutConstraint, LayoutConstraint) for full details on the LayoutConstraint API and chaining child constraints.

Parameters:

constr - The general layout constraints for the MigLayout.

rowConstr - The row constraints for the MigLayout.

Returns:

A Layout.ForMigLayout configured with the supplied constraints.

mig

static Layout.ForMigLayout mig(LayoutConstraint constr)

A factory method for creating a MigLayout-based layout configuration from a single type-safe LayoutConstraint, with no column or row constraints. This is the preferred approach over the plain-String overload.

See mig(LayoutConstraint, LayoutConstraint, LayoutConstraint) for full details on the LayoutConstraint API and chaining child constraints.

Parameters:

constr - The general layout constraints for the MigLayout.

Returns:

A Layout.ForMigLayout configured with the supplied constraints.

mig

static Layout.ForMigLayout mig(LayoutConstraint constr,
 MigAddConstraint... childConstraints)

A convenience factory method that creates a MigLayout-based layout configuration from a single type-safe LayoutConstraint together with per-child MigAddConstraints for the component's direct children.

The childConstraints are mapped positionally: the first entry is applied to the first child, the second to the second child, and so on. Excess entries (more constraints than children) are silently ignored; children without a matching entry keep whatever constraint the parent MigLayout already has for them.

This is a shorthand for:

      Layout.mig(constr).withChildConstraints(childConstraints)
  

See mig(LayoutConstraint, LayoutConstraint, LayoutConstraint) for full details on the LayoutConstraint API.

Parameters:

constr - The general layout constraints for the MigLayout.

childConstraints - The MigAddConstraints to apply to the component's children, in child-index order.

Returns:

A Layout.ForMigLayout configured with the supplied constraints.

mig

static Layout.ForMigLayout mig(String constr,
 String colConstr,
 String rowConstr)

A convenience overload of mig(LayoutConstraint, LayoutConstraint, LayoutConstraint) that accepts plain constraint strings instead of LayoutConstraint objects. Each string is wrapped via LayoutConstraint.of(String...) before being forwarded.

Prefer the LayoutConstraint-based overloads for new code, as they are composable and less error-prone than raw strings. Click here for more information about MigLayout.

Parameters:

constr - The general layout constraints string for the MigLayout.

colConstr - The column constraints string for the MigLayout.

rowConstr - The row constraints string for the MigLayout.

Returns:

A Layout.ForMigLayout configured with the supplied constraints.

mig

static Layout.ForMigLayout mig(String constr,
 String rowConstr)

A convenience overload of mig(LayoutConstraint, LayoutConstraint) that accepts plain constraint strings instead of LayoutConstraint objects. Each string is wrapped via LayoutConstraint.of(String...) before being forwarded.

Prefer the LayoutConstraint-based overloads for new code, as they are composable and less error-prone than raw strings. Click here for more information about MigLayout.

Parameters:

constr - The general layout constraints string for the MigLayout.

rowConstr - The row constraints string for the MigLayout.

Returns:

A Layout.ForMigLayout configured with the supplied constraints.

mig

static Layout.ForMigLayout mig(String constr)

A convenience overload of mig(LayoutConstraint) that accepts a plain constraint string instead of a LayoutConstraint object. The string is wrapped via LayoutConstraint.of(String...) before being forwarded.

Prefer the LayoutConstraint-based overloads for new code, as they are composable and less error-prone than raw strings. In case you are not familiar with the MigLayout constraints, you can find more information about them here.

Parameters:

constr - The general layout constraints string for the MigLayout.

Returns:

A Layout.ForMigLayout configured with the supplied constraints.

mig

static Layout.ForMigLayout mig(String constr,
 MigAddConstraint... childConstraints)

A convenience factory method that creates a MigLayout-based layout configuration from a plain constraint string together with per-child MigAddConstraints for the component's direct children.

The childConstraints are mapped positionally: the first entry is applied to the first child, the second to the second child, and so on. This is a shorthand for:

      Layout.mig(constr).withChildConstraints(childConstraints)
  

Prefer the LayoutConstraint-based overload mig(LayoutConstraint, MigAddConstraint...) for new code.

Parameters:

constr - The general layout constraints string for the MigLayout.

childConstraints - The MigAddConstraints to apply to the component's children, in child-index order.

Returns:

A Layout.ForMigLayout configured with the supplied constraints.

flow

static Layout.ForFlowLayout flow(UI.HorizontalAlignment align,
 int hgap,
 int vgap)

A factory method for creating a Layout.ForFlowLayout configuration that installs a ResponsiveGridFlowLayout onto a component with the given alignment and gaps.

The returned Layout.ForFlowLayout supports fluent chaining to specify per-child FlowCell constraints via the various Layout.ForFlowLayout.withChildConstraints(FlowCell...) overloads, enabling fully reactive responsive layouts when used together with UIForAnySwing.withLayout(sprouts.Val).

Parameters:

align - The alignment for the layout, which has to be one of

• UI.HorizontalAlignment.LEFT
• UI.HorizontalAlignment.CENTER
• UI.HorizontalAlignment.RIGHT
• UI.HorizontalAlignment.LEADING
• UI.HorizontalAlignment.TRAILING

hgap - The horizontal gap between components, in pixels.

vgap - The vertical gap between component rows, in pixels.

Returns:

A Layout.ForFlowLayout configured with the supplied alignment and gaps.

flow

static Layout.ForFlowLayout flow(UI.HorizontalAlignment align)

A factory method for creating a Layout.ForFlowLayout configuration that installs a ResponsiveGridFlowLayout with the given alignment and default gaps of 5 pixels.

The returned Layout.ForFlowLayout supports fluent chaining to specify per-child FlowCell constraints. See flow(UI.HorizontalAlignment, int, int) for full details.

Parameters:

align - The horizontal alignment for the flow of components.

Returns:

A Layout.ForFlowLayout configured with the supplied alignment.

flow

static Layout.ForFlowLayout flow()

A factory method for creating a Layout.ForFlowLayout configuration that installs a ResponsiveGridFlowLayout with centered alignment and default gaps of 5 pixels.

The returned Layout.ForFlowLayout supports fluent chaining to specify per-child FlowCell constraints. See flow(UI.HorizontalAlignment, int, int) for full details.

Returns:

A Layout.ForFlowLayout with centered alignment and 5-pixel gaps.

flow

static Layout.ForFlowLayout flow(FlowCell... childConstraints)

A convenience factory method that creates a centered Layout.ForFlowLayout pre-loaded with per-child FlowCell constraints. This is a shorthand for:

      Layout.flow().withChildConstraints(childConstraints)
  

Each FlowCell is typically created via UILayoutConstants.AUTO_SPAN(Configurator):

      import static swingtree.UI.*;
      // ...
      Var<Layout> layout = Var.of(
          Layout.flow(
              AUTO_SPAN( it -> it.small(12).medium(6) ),
              AUTO_SPAN( it -> it.small(12).medium(6) )
          )
      );
      UI.panel()
        .withLayout(layout)
        .add( label("Left") )
        .add( label("Right") );
  

Changing the layout property at runtime will reinstall the layout and re-push all child FlowCell constraints, making the span behaviour fully reactive.

Parameters:

childConstraints - The FlowCell constraints to apply to the component's children in child-index order.

Returns:

A Layout.ForFlowLayout with centered alignment and the given child constraints.

flow

static Layout.ForFlowLayout flow(UI.HorizontalAlignment align,
 FlowCell... childConstraints)

A convenience factory method that creates a Layout.ForFlowLayout with the given alignment and per-child FlowCell constraints pre-loaded. This is a shorthand for:

      Layout.flow(align).withChildConstraints(childConstraints)
  

See flow(FlowCell...) for a usage example and reactive design notes.

Parameters:

align - The horizontal alignment for the flow of components.

childConstraints - The FlowCell constraints to apply to the component's children in child-index order.

Returns:

A Layout.ForFlowLayout with the given alignment and child constraints.

border

static Layout border(int horizontalGap,
 int verticalGap)

A factory method for creating a layout that installs the BorderLayout onto a component based on the supplied parameters.

Parameters:

horizontalGap - The horizontal gap for the layout.

verticalGap - The vertical gap for the layout.

Returns:

A layout that installs the BorderLayout onto a component.

border

static Layout border()

A factory method for creating a layout that installs the BorderLayout onto a component based on the supplied parameters. The installed layout will have a default gap of 0 pixels.

Returns:

A layout that installs the BorderLayout onto a component.

grid

static Layout.ForGridLayout grid(int rows,
 int cols,
 int horizontalGap,
 int verticalGap)

A factory method for a Layout.ForGridLayout which installs a UniformGridLayout with the given numbers of rows and columns and the given gaps onto a component. The grid is built in the mode UniformGridLayout.Mode.WRAP_AFTER_COLUMNS and leaves out the rows and columns which no child occupies (UniformGridLayout.CollapseEmpty.ROWS_AND_COLUMNS).

So in a style like it.layout(Layout.grid(2, 5, 5, 5)), 8 children are laid out in 2 rows of 5 columns, and 3 children share the whole component in a single row of 3 columns. A number of rows or columns of 0 means "as many as the children need", and the gaps are scaled by the UI scale factor every time the component is laid out. Use grid(UniformGridLayout.Mode, UniformGridLayout.CollapseEmpty, int, int, int, int) to choose other settings.

Parameters:

rows - The number of rows, or 0 for as many rows as the children need.

cols - The number of columns, or 0 for as many columns as the children need.

horizontalGap - The space between neighbouring columns, in pixels at a UI scale factor of 1.

verticalGap - The space between neighbouring rows, in pixels at a UI scale factor of 1.

Returns:

A Layout.ForGridLayout which installs a UniformGridLayout onto a component.

grid

static Layout.ForGridLayout grid(int rows,
 int cols)

A factory method for a Layout.ForGridLayout which installs a UniformGridLayout with the given numbers of rows and columns and no gaps onto a component. The grid is built in the mode UniformGridLayout.Mode.WRAP_AFTER_COLUMNS and leaves out the rows and columns which no child occupies (UniformGridLayout.CollapseEmpty.ROWS_AND_COLUMNS). See grid(int, int, int, int) for an example.

Parameters:

rows - The number of rows, or 0 for as many rows as the children need.

cols - The number of columns, or 0 for as many columns as the children need.

Returns:

A Layout.ForGridLayout which installs a UniformGridLayout onto a component.

grid

static Layout.ForGridLayout grid(UniformGridLayout.Mode mode,
 UniformGridLayout.CollapseEmpty collapseEmpty,
 int rows,
 int cols,
 int horizontalGap,
 int verticalGap)

A factory method for a Layout.ForGridLayout which installs a UniformGridLayout with the given settings, numbers of rows and columns and gaps onto a component.

The mode decides how the grid is built from the numbers of rows and columns, and collapseEmpty decides which of the rows and columns that no child occupies are left out. So in a style like it.layout(Layout.grid(Mode.SPREAD_OVER_ROWS, CollapseEmpty.NONE, 2, 5, 5, 5)), the children are spread over 2 rows with every empty cell kept, and with Layout.grid(Mode.WRAP_AFTER_COLUMNS, CollapseEmpty.NONE, 2, 5, 5, 5), 3 children take the first 3 cells of a grid of 2 rows and 5 columns. To lay children out exactly like a GridLayout, add OverflowGrowth.ADD_COLUMNS through grid(UniformGridLayout.Mode, UniformGridLayout.CollapseEmpty, UniformGridLayout.OverflowGrowth, int, int, int, int), which is the growth policy that makes room the way a GridLayout makes room. See UniformGridLayout.Mode and UniformGridLayout.CollapseEmpty for what each setting does.

Parameters:

mode - How the grid is built from the numbers of rows and columns.

collapseEmpty - Which of the rows and columns that no child occupies are left out.

rows - The number of rows, or 0 for as many rows as the children need.

cols - The number of columns, or 0 for as many columns as the children need.

horizontalGap - The space between neighbouring columns, in pixels at a UI scale factor of 1.

verticalGap - The space between neighbouring rows, in pixels at a UI scale factor of 1.

Returns:

A Layout.ForGridLayout which installs a UniformGridLayout onto a component.

grid

static Layout.ForGridLayout grid(UniformGridLayout.Mode mode,
 UniformGridLayout.CollapseEmpty collapseEmpty,
 int rows,
 int cols)

A factory method for a Layout.ForGridLayout which installs a UniformGridLayout with the given settings and numbers of rows and columns, and no gaps, onto a component. See grid(UniformGridLayout.Mode, UniformGridLayout.CollapseEmpty, int, int, int, int) for what the settings do.

Parameters:

mode - How the grid is built from the numbers of rows and columns.

collapseEmpty - Which of the rows and columns that no child occupies are left out.

rows - The number of rows, or 0 for as many rows as the children need.

cols - The number of columns, or 0 for as many columns as the children need.

Returns:

A Layout.ForGridLayout which installs a UniformGridLayout onto a component.

grid

static Layout.ForGridLayout grid(UniformGridLayout.Mode mode,
 UniformGridLayout.CollapseEmpty collapseEmpty,
 UniformGridLayout.OverflowGrowth overflowGrowth,
 int rows,
 int cols,
 int horizontalGap,
 int verticalGap)

A factory method for a Layout.ForGridLayout which installs a UniformGridLayout with every one of its settings, the given numbers of rows and columns and the given gaps onto a component.

On top of grid(UniformGridLayout.Mode, UniformGridLayout.CollapseEmpty, int, int, int, int), overflowGrowth decides how the grid grows when it holds more children than cells. So in a style like it.layout(Layout.grid(Mode.WRAP_AFTER_COLUMNS, CollapseEmpty.NONE, OverflowGrowth.ADD_ROWS_AND_COLUMNS, 2, 5, 5, 5)), 13 children are laid out in 3 rows of 6 columns, because growing both numbers keeps the grid closer to the declared ratio of 2 rows to 5 columns than a third row alone would. See UniformGridLayout.OverflowGrowth for what each setting does.

Parameters:

mode - How the grid is built from the numbers of rows and columns.

collapseEmpty - Which of the rows and columns that no child occupies are left out.

overflowGrowth - How the grid grows when it holds more children than cells.

rows - The number of rows, or 0 for as many rows as the children need.

cols - The number of columns, or 0 for as many columns as the children need.

horizontalGap - The space between neighbouring columns, in pixels at a UI scale factor of 1.

verticalGap - The space between neighbouring rows, in pixels at a UI scale factor of 1.

Returns:

A Layout.ForGridLayout which installs a UniformGridLayout onto a component.

grid

static Layout.ForGridLayout grid(UniformGridLayout.Mode mode,
 UniformGridLayout.CollapseEmpty collapseEmpty,
 UniformGridLayout.OverflowGrowth overflowGrowth,
 int rows,
 int cols)

A factory method for a Layout.ForGridLayout which installs a UniformGridLayout with every one of its settings and the given numbers of rows and columns, and no gaps, onto a component. See grid(UniformGridLayout.Mode, UniformGridLayout.CollapseEmpty, UniformGridLayout.OverflowGrowth, int, int, int, int) for what the settings do.

Parameters:

mode - How the grid is built from the numbers of rows and columns.

collapseEmpty - Which of the rows and columns that no child occupies are left out.

overflowGrowth - How the grid grows when it holds more children than cells.

rows - The number of rows, or 0 for as many rows as the children need.

cols - The number of columns, or 0 for as many columns as the children need.

Returns:

A Layout.ForGridLayout which installs a UniformGridLayout onto a component.

box

static Layout box(UI.Axis axis)

A factory method for creating a layout that installs the BoxLayout onto a component based on the supplied UI.Axis parameter. The axis determines whether the layout will be a horizontal or vertical BoxLayout.

Parameters:

axis - The axis for the layout, which has to be one of

• UI.Axis.HORIZONTAL
• UI.Axis.VERTICAL
• UI.Axis.LINE
• UI.Axis.PAGE

Returns:

A layout that installs the BoxLayout onto a component.

box

static Layout box()

A factory method for creating a layout that installs the BoxLayout onto a component with a default axis of UI.Axis.HORIZONTAL.

Returns:

A layout that installs the default BoxLayout onto a component.