Packages  This Package  Prev  Next  Index  

§1.23 Class GridLayout

public  class  java.awt.GridLayout
    extends  java.lang.Object  (I-§1.12)
    implements java.awt.LayoutManager  (II-§1.43)
{
        // Constructors
    public GridLayout(int  rows, int  cols);	§1.23.1
    public GridLayout(int  rows, int  cols,	§1.23.2
                       int  hgap, int  vgap);
        // Methods
    public void addLayoutComponent(String  name,	§1.23.3
                              Component  comp);
    public void layoutContainer(Container  target);	§1.23.4
    public Dimension minimumLayoutSize(Container  target);	§1.23.5
    public Dimension preferredLayoutSize(Container  target);	§1.23.6
    public void removeLayoutComponent(Component  comp);	§1.23.7
    public String toString();	§1.23.8
}
This grid layout manager causes the container's components to be laid out in a rectangular grid. The container is split into equal-sized rectangles: one component is placed into each rectangle.

For example, the following code says to lay out the six buttons into three rows and two columns:


import java.awt.*; import java.applet.Applet; public class buttonGrid extends Applet { public void init() { setLayout(new GridLayout(3,2)); add(new Button("1")); add(new Button("2")); add(new Button("3")); add(new Button("4")); add(new Button("5")); add(new Button("6")); } }
It produces the following output:


Constructors

GridLayout

public GridLayout(int rows, int cols)
Creates a grid layout with the specified number of rows and columns. All components in the layout are given equal size.
One, but not both of rows and columns can be zero, which means that any number of objects can be placed in a row or in a column
Parameters:
rows - the rows; zero means "any number"
cols - the columns; zero means "any number"

GridLayout

public GridLayout(int rows, int cols, int hgap, int vgap)
Creates a grid layout with the specified number of rows and columns. All components in the layout are given equal size.
In addition the horizontal and vertical gaps are set to the specified values. The horizontal gaps are placed at the left and right edge, and between each of the columns. The vertical gaps are placed at the top and bottom edge, and between each of the rows.
One, but not both of rows and columns can be zero, which means that any number of objects can be placed in a row or in a column
Parameters:
rows - the rows; zero means "any number"
cols - the columns; zero means "any number"
hgap - the horizontal gap
vgap - the vertical gap

Methods

addLayoutComponent

public void addLayoutComponent(String name, Component comp)
This method is not used by the grid layout manager.
Parameters:
name - a tag
comp - the component to be added

layoutContainer

public void layoutContainer(Container target)
Lays out the container argument using this layout.
This method reshapes the components in the specified target container in order to satisfy the constraints of the GridLayout object.
The grid layout manager determines the size of individual components by dividing the free space in the container into equal-sized portions according to the number of rows and columns in the layout. The container's free space equals the container's size minus any insets and any specified horizontal or vertical gap. All components in a grid layout are given the same size
Most applications do not call this method directly. This method is called when a container calls its layout method (II-§1.11.11).

Parameters:
target - the container in which to do the layout
See Also:
Container (II-§1.11).

minimumLayoutSize

public Dimension minimumLayoutSize(Container target)
Determines the minimum size of the container argument using this grid layout.
The minimum width of a grid layout is the largest minimum width of any of the widths in the container times the number of columns, plus the horizontal padding times the number of columns plus 1, plus the left and right insets of the target container.
The minimum height of a grid layout is the largest minimum height of any of the widths in the container times the number of rows, plus the vertical padding times the number of rows plus 1, plus the top and left insets of the target container.
Most applications do not call this method directly. This method is called when a container calls its layout method (II-§1.11.11).

Parameters:
target - the container in which to do the layout
Returns:
the minimum dimensions needed to lay out the subcomponents of the specified container.
See Also:
preferredLayoutSize (II-§1.23.6).

preferredLayoutSize

public Dimension preferredLayoutSize(Container target)
Determines the preferred size of the container argument using this grid layout.
The preferred width of a grid layout is the largest preferred width of any of the widths in the container times the number of columns, plus the horizontal padding times the number of columns plus 1, plus the left and right insets of the target container.
The preferred height of a grid layout is the largest preferred height of any of the widths in the container times the number of rows, plus the vertical padding times the number of rows plus 1, plus the top and left insets of the target container.
Most applications do not call this method directly. This method is called when a container calls its preferredSize method (II-§1.11.17).

Parameters:
target - the container in which to do the layout
Returns:
the preferred dimensions to lay out the subcomponents of the specified container.
See Also:
minimumLayoutSize (II-§1.23.5).

removeLayoutComponent

public void removeLayoutComponent(Component comp)
This method is not used by the grid layout manager.
Parameters:
comp - the component to be removed

toString

public String toString()
Returns:
a string representation of this grid layout.
Overrides:
toString in class Object (I-§1.12.9).

Packages  This Package  Prev  Next  Index
Java API Document (HTML generated by dkramer on April 22, 1996)
Copyright © 1996 Sun Microsystems, Inc. All rights reserved
Please send any comments or corrections to doug.kramer@sun.com