ilog.views.util.swing.layout

Class IlvGridFlowLayout

java.lang.Object

java.awt.GridLayout

ilog.views.util.swing.layout.IlvGridFlowLayout

All Implemented Interfaces:

LayoutManager, Serializable, SwingConstants

public class IlvGridFlowLayout
extends GridLayout
implements SwingConstants

IlvGridFlowLayout is an extension of GridLayout that lays out the components of a container in a rectangular grid. The container is divided into equal-sized rectangles and one component is placed in each rectangle. The class IlvGridFlowLayout automatically computes the number of rows and columns by first making the components flow along either the horizontal or vertical axis. When no more components will fit along the flow axis, the layout adds grid cells along the orthogonal axis as needed to accommodate the overflow components.

The fact that IlvGridFlowLayout has a preferred flow axis means that panels using this layout work better in certain contexts than others. For example, a panel with a horizontal IlvGridFlowLayout will layout nicely when the panel is placed in the north or south areas of a BorderLayout. A panel with the same layout will layout less nicely when it is placed in the east or west areas of a BorderLayout. Conversely, a panel with a vertical IlvGridFlowLayout will layout nicely when the panel is placed in the east or west areas of a BorderLayout, but will layout less nicely when placed in the north or south areas of a BorderLayout.

Since:

JViews 8.1

See Also:

Serialized Form

Field Summary

Fields inherited from interface javax.swing.SwingConstants

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

Constructor Summary

Constructors

Constructor and Description
IlvGridFlowLayout(int flowDirection) Creates a grid layout that automatically computes the number of rows and columns by making components flow along the specified direction until no more components fit.
IlvGridFlowLayout(int flowDirection, int hgap, int vgap) Creates a grid layout that automatically computes the number of rows and columns by making components flow along the specified direction until no more components fit.

Method Summary

Modifier and Type	Method and Description
void	layoutContainer(Container container) Lays out the specified container using this layout.
Dimension	minimumLayoutSize(Container container) Determines the minimum size of the container argument using this grid layout.
Dimension	preferredLayoutSize(Container container) Determines the preferred size of the container argument using this layout.

Methods inherited from class java.awt.GridLayout

addLayoutComponent, getColumns, getHgap, getRows, getVgap, removeLayoutComponent, setColumns, setHgap, setRows, setVgap, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvGridFlowLayout

public IlvGridFlowLayout(int flowDirection)

Creates a grid layout that automatically computes the number of rows and columns by making components flow along the specified direction until no more components fit. Then cells are added along the orthogonal axis as needed to accommodate the overflow components.

Parameters:

flowDirection - The layout flow direction. The value must be one of the Swing constants SwingConstants.HORIZONTAL or SwingConstants.VERTICAL.

IlvGridFlowLayout

public IlvGridFlowLayout(int flowDirection,
                         int hgap,
                         int vgap)

Creates a grid layout that automatically computes the number of rows and columns by making components flow along the specified direction until no more components fit. Then cells are added along the orthogonal axis as needed to accommodate the overflow components.

Parameters:

flowDirection - The layout flow direction. The value must be one of the Swing constants SwingConstants.HORIZONTAL or SwingConstants.VERTICAL.

hgap - The horizontal gap placed between each grid column.

vgap - The vertical gap placed between each grid row.

Method Detail

layoutContainer

public void layoutContainer(Container container)

Lays out the specified container using this layout.

This method reshapes the components in the specified target container in order to satisfy the constraints of the layout.

Specified by:

layoutContainer in interface LayoutManager

Overrides:

layoutContainer in class GridLayout

Parameters:

container - The container in which to do the layout.

preferredLayoutSize

public Dimension preferredLayoutSize(Container container)

Determines the preferred size of the container argument using this layout.

Specified by:

preferredLayoutSize in interface LayoutManager

Overrides:

preferredLayoutSize in class GridLayout

Parameters:

container - The container in which to do the layout.

Returns:

The preferred dimensions to lay out the subcomponents of the specified container.

minimumLayoutSize

public Dimension minimumLayoutSize(Container container)

Determines the minimum size of the container argument using this grid layout.

Specified by:

minimumLayoutSize in interface LayoutManager

Overrides:

minimumLayoutSize in class GridLayout

Parameters:

container - The container in which to do the layout.

Returns:

The minimum dimensions needed to lay out the subcomponents of the specified container.