Index (Frames) | Index (No Frames) | Package | Package Tree | Tree
java.awt

Class GridLayout

java.lang.Object
|
+--java.awt.GridLayout

All Implemented Interfaces:

LayoutManager, Serializable


public class GridLayout

extends Object

implements LayoutManager, Serializable

This class implements a grid-based layout scheme. Components are all given the same size and are laid out from left to right and top to bottom. A GridLayout is configured with a number of rows and a number of columns. If both are specified, then the number of columns is ignored and is derived from the number of rows and the total number of components. If either is zero then that dimension is computed based on the actual size of the container. An exception is thrown if an attempt is made to set both the number of rows and the number of columns to 0. This class also supports horizontal and vertical gaps; these are used as spacing between cells.

Authors:

Constructor Summary

GridLayout()

Create a new GridLayout with one row and any number of columns.
GridLayout(int rows, int cols)

Create a new GridLayout with the specified number of rows and columns.
GridLayout(int rows, int cols, int hgap, int vgap)

Create a new GridLayout with the specified number of rows and columns and the specified gaps.

Method Summary

voidaddLayoutComponent(java.lang.String name, java.awt.Component comp)

Add a new component to the layout.
intgetColumns()

Return the number of columns in this layout.
intgetHgap()

Return the horizontal gap.
intgetRows()

Return the number of rows in this layout.
intgetVgap()

Return the vertical gap.
voidlayoutContainer(java.awt.Container parent)

Lay out the container's components based on current settings.
java.awt.DimensionminimumLayoutSize(java.awt.Container cont)

Get the minimum layout size of the container.
java.awt.DimensionpreferredLayoutSize(java.awt.Container cont)

Get the preferred layout size of the container.
voidremoveLayoutComponent(java.awt.Component comp)

Remove the indicated component from this layout manager.
voidsetColumns(int newCols)

Set the number of columns.
voidsetHgap(int hgap)

Set the horizontal gap
voidsetRows(int newRows)

Set the number of rows
voidsetVgap(int vgap)

Set the vertical gap.
java.lang.StringtoString()

Return String description of this object.

Constructor Details

GridLayout

public GridLayout()

Create a new GridLayout with one row and any number of columns. Both gaps are set to 0.


GridLayout

public GridLayout(int rows, int cols)

Create a new GridLayout with the specified number of rows and columns. Both gaps are set to 0. Note that the row and column settings cannot both be zero. If both the row and column values are non-zero, the rows value takes precedence.

Parameters:

Throws:


GridLayout

public GridLayout(int rows, int cols, int hgap, int vgap)

Create a new GridLayout with the specified number of rows and columns and the specified gaps. Note that the row and column settings cannot both be zero. If both the row and column values are non-zero, the rows value takes precedence.

Parameters:

Throws:


Method Details

addLayoutComponent

public void addLayoutComponent(java.lang.String name, java.awt.Component comp)

Add a new component to the layout. This particular implementation does nothing.

Parameters:


getColumns

public int getColumns()

Return the number of columns in this layout.


getHgap

public int getHgap()

Return the horizontal gap.


getRows

public int getRows()

Return the number of rows in this layout.


getVgap

public int getVgap()

Return the vertical gap.


layoutContainer

public void layoutContainer(java.awt.Container parent)

Lay out the container's components based on current settings. The free space in the container is divided evenly into the specified number of rows and columns in this object.

Parameters:


minimumLayoutSize

public Dimension minimumLayoutSize(java.awt.Container cont)

Get the minimum layout size of the container.

Parameters:


preferredLayoutSize

public Dimension preferredLayoutSize(java.awt.Container cont)

Get the preferred layout size of the container.

Parameters:


removeLayoutComponent

public void removeLayoutComponent(java.awt.Component comp)

Remove the indicated component from this layout manager. This particular implementation does nothing.

Parameters:


setColumns

public void setColumns(int newCols)

Set the number of columns.

Parameters:

Throws:


setHgap

public void setHgap(int hgap)

Set the horizontal gap

Parameters:

Throws:


setRows

public void setRows(int newRows)

Set the number of rows

Parameters:

Throws:


setVgap

public void setVgap(int vgap)

Set the vertical gap.

Parameters:

Throws:


toString

public String toString()

Return String description of this object.