java.awt
Interface LayoutManager2

All Superinterfaces:

LayoutManager

All Known Implementing Classes:

BorderLayout, BoxLayout, CardLayout, javax.swing.JToolBar.DefaultToolBarLayout, GridBagLayout, OverlayLayout, javax.swing.JRootPane.RootLayout, SpringLayout

public interface LayoutManager2

extends LayoutManager

Safe: Defines an interface for classes that know how to layout Containers based on a layout constraints object. This interface extends the LayoutManager interface to deal with layouts explicitly in terms of constraint objects that specify how and where components should be added to the layout.

This minimal extension to LayoutManager is intended for tool providers who wish to the creation of constraint-based layouts. It does not yet provide full, general support for custom constraint-based layout managers.

Version:

1.12, 12/03/01

Author:

Jonni Kanerva

See Also:

LayoutManager, Container

Method Summary

void	addLayoutComponent(Component comp, Object constraints) Enabled: Adds the specified component to the layout, using the specified constraint object.
float	getLayoutAlignmentX(Container target) Enabled: Returns the alignment along the x axis.
float	getLayoutAlignmentY(Container target) Enabled: Returns the alignment along the y axis.
void	invalidateLayout(Container target) Enabled: Invalidates the layout, indicating that if the layout manager has cached information it should be discarded.
Dimension	maximumLayoutSize(Container target) Enabled: Calculates the maximum size dimensions for the specified container, given the components it contains.

Methods inherited from interface java.awt.LayoutManager

addLayoutComponent, layoutContainer, minimumLayoutSize, preferredLayoutSize, removeLayoutComponent

Method Detail

addLayoutComponent

public void addLayoutComponent(Component comp,
                               Object constraints)

Enabled: Adds the specified component to the layout, using the specified constraint object.

Parameters:

comp - the component to be added

constraints - where/how the component is added to the layout.

maximumLayoutSize

public Dimension maximumLayoutSize(Container target)

Enabled: Calculates the maximum size dimensions for the specified container, given the components it contains.

See Also:

java.awt.Component#getMaximumSize, LayoutManager

getLayoutAlignmentX

public float getLayoutAlignmentX(Container target)

Enabled: Returns the alignment along the x axis. This specifies how the component would like to be aligned relative to other components. The value should be a number between 0 and 1 where 0 represents alignment along the origin, 1 is aligned the furthest away from the origin, 0.5 is centered, etc.

getLayoutAlignmentY

public float getLayoutAlignmentY(Container target)

Enabled: Returns the alignment along the y axis. This specifies how the component would like to be aligned relative to other components. The value should be a number between 0 and 1 where 0 represents alignment along the origin, 1 is aligned the furthest away from the origin, 0.5 is centered, etc.

invalidateLayout

public void invalidateLayout(Container target)

Enabled: Invalidates the layout, indicating that if the layout manager has cached information it should be discarded.