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.



comments?