FileDocCategorySizeDatePackage
GridBagConstraints.javaAPI DocJava SE 6 API23134Tue Jun 10 00:25:16 BST 2008java.awt

GridBagConstraints

public class GridBagConstraints extends Object implements Cloneable, Serializable
The GridBagConstraints class specifies constraints for components that are laid out using the GridBagLayout class.
version
1.41, 05/26/06
author
Doug Stein
author
Bill Spitzak (orignial NeWS & OLIT implementation)
see
java.awt.GridBagLayout
since
JDK1.0

Fields Summary
public static final int
RELATIVE
Specifies that this component is the next-to-last component in its column or row (gridwidth, gridheight), or that this component be placed next to the previously added component (gridx, gridy).
public static final int
REMAINDER
Specifies that this component is the last component in its column or row.
public static final int
NONE
Do not resize the component.
public static final int
BOTH
Resize the component both horizontally and vertically.
public static final int
HORIZONTAL
Resize the component horizontally but not vertically.
public static final int
VERTICAL
Resize the component vertically but not horizontally.
public static final int
CENTER
Put the component in the center of its display area.
public static final int
NORTH
Put the component at the top of its display area, centered horizontally.
public static final int
NORTHEAST
Put the component at the top-right corner of its display area.
public static final int
EAST
Put the component on the right side of its display area, centered vertically.
public static final int
SOUTHEAST
Put the component at the bottom-right corner of its display area.
public static final int
SOUTH
Put the component at the bottom of its display area, centered horizontally.
public static final int
SOUTHWEST
Put the component at the bottom-left corner of its display area.
public static final int
WEST
Put the component on the left side of its display area, centered vertically.
public static final int
NORTHWEST
Put the component at the top-left corner of its display area.
public static final int
PAGE_START
Place the component centered along the edge of its display area associated with the start of a page for the current ComponentOrienation. Equal to NORTH for horizontal orientations.
public static final int
PAGE_END
Place the component centered along the edge of its display area associated with the end of a page for the current ComponentOrienation. Equal to SOUTH for horizontal orientations.
public static final int
LINE_START
Place the component centered along the edge of its display area where lines of text would normally begin for the current ComponentOrienation. Equal to WEST for horizontal, left-to-right orientations and EAST for horizontal, right-to-left orientations.
public static final int
LINE_END
Place the component centered along the edge of its display area where lines of text would normally end for the current ComponentOrienation. Equal to EAST for horizontal, left-to-right orientations and WEST for horizontal, right-to-left orientations.
public static final int
FIRST_LINE_START
Place the component in the corner of its display area where the first line of text on a page would normally begin for the current ComponentOrienation. Equal to NORTHWEST for horizontal, left-to-right orientations and NORTHEAST for horizontal, right-to-left orientations.
public static final int
FIRST_LINE_END
Place the component in the corner of its display area where the first line of text on a page would normally end for the current ComponentOrienation. Equal to NORTHEAST for horizontal, left-to-right orientations and NORTHWEST for horizontal, right-to-left orientations.
public static final int
LAST_LINE_START
Place the component in the corner of its display area where the last line of text on a page would normally start for the current ComponentOrienation. Equal to SOUTHWEST for horizontal, left-to-right orientations and SOUTHEAST for horizontal, right-to-left orientations.
public static final int
LAST_LINE_END
Place the component in the corner of its display area where the last line of text on a page would normally end for the current ComponentOrienation. Equal to SOUTHEAST for horizontal, left-to-right orientations and SOUTHWEST for horizontal, right-to-left orientations.
public static final int
BASELINE
Possible value for the anchor field. Specifies that the component should be horizontally centered and vertically aligned along the baseline of the prevailing row. If the component does not have a baseline it will be vertically centered.
public static final int
BASELINE_LEADING
Possible value for the anchor field. Specifies that the component should be horizontally placed along the leading edge. For components with a left-to-right orientation, the leading edge is the left edge. Vertically the component is aligned along the baseline of the prevailing row. If the component does not have a baseline it will be vertically centered.
public static final int
BASELINE_TRAILING
Possible value for the anchor field. Specifies that the component should be horizontally placed along the trailing edge. For components with a left-to-right orientation, the trailing edge is the right edge. Vertically the component is aligned along the baseline of the prevailing row. If the component does not have a baseline it will be vertically centered.
public static final int
ABOVE_BASELINE
Possible value for the anchor field. Specifies that the component should be horizontally centered. Vertically the component is positioned so that its bottom edge touches the baseline of the starting row. If the starting row does not have a baseline it will be vertically centered.
public static final int
ABOVE_BASELINE_LEADING
Possible value for the anchor field. Specifies that the component should be horizontally placed along the leading edge. For components with a left-to-right orientation, the leading edge is the left edge. Vertically the component is positioned so that its bottom edge touches the baseline of the starting row. If the starting row does not have a baseline it will be vertically centered.
public static final int
ABOVE_BASELINE_TRAILING
Possible value for the anchor field. Specifies that the component should be horizontally placed along the trailing edge. For components with a left-to-right orientation, the trailing edge is the right edge. Vertically the component is positioned so that its bottom edge touches the baseline of the starting row. If the starting row does not have a baseline it will be vertically centered.
public static final int
BELOW_BASELINE
Possible value for the anchor field. Specifies that the component should be horizontally centered. Vertically the component is positioned so that its top edge touches the baseline of the starting row. If the starting row does not have a baseline it will be vertically centered.
public static final int
BELOW_BASELINE_LEADING
Possible value for the anchor field. Specifies that the component should be horizontally placed along the leading edge. For components with a left-to-right orientation, the leading edge is the left edge. Vertically the component is positioned so that its top edge touches the baseline of the starting row. If the starting row does not have a baseline it will be vertically centered.
public static final int
BELOW_BASELINE_TRAILING
Possible value for the anchor field. Specifies that the component should be horizontally placed along the trailing edge. For components with a left-to-right orientation, the trailing edge is the right edge. Vertically the component is positioned so that its top edge touches the baseline of the starting row. If the starting row does not have a baseline it will be vertically centered.
public int
gridx
Specifies the cell containing the leading edge of the component's display area, where the first cell in a row has gridx=0. The leading edge of a component's display area is its left edge for a horizontal, left-to-right container and its right edge for a horizontal, right-to-left container. The value RELATIVE specifies that the component be placed immediately following the component that was added to the container just before this component was added.

The default value is RELATIVE. gridx should be a non-negative value.

public int
gridy
Specifies the cell at the top of the component's display area, where the topmost cell has gridy=0. The value RELATIVE specifies that the component be placed just below the component that was added to the container just before this component was added.

The default value is RELATIVE. gridy should be a non-negative value.

public int
gridwidth
Specifies the number of cells in a row for the component's display area.

Use REMAINDER to specify that the component's display area will be from gridx to the last cell in the row. Use RELATIVE to specify that the component's display area will be from gridx to the next to the last one in its row.

gridwidth should be non-negative and the default value is 1.

public int
gridheight
Specifies the number of cells in a column for the component's display area.

Use REMAINDER to specify that the component's display area will be from gridy to the last cell in the column. Use RELATIVE to specify that the component's display area will be from gridy to the next to the last one in its column.

gridheight should be a non-negative value and the default value is 1.

public double
weightx
Specifies how to distribute extra horizontal space.

The grid bag layout manager calculates the weight of a column to be the maximum weightx of all the components in a column. If the resulting layout is smaller horizontally than the area it needs to fill, the extra space is distributed to each column in proportion to its weight. A column that has a weight of zero receives no extra space.

If all the weights are zero, all the extra space appears between the grids of the cell and the left and right edges.

The default value of this field is 0. weightx should be a non-negative value.

public double
weighty
Specifies how to distribute extra vertical space.

The grid bag layout manager calculates the weight of a row to be the maximum weighty of all the components in a row. If the resulting layout is smaller vertically than the area it needs to fill, the extra space is distributed to each row in proportion to its weight. A row that has a weight of zero receives no extra space.

If all the weights are zero, all the extra space appears between the grids of the cell and the top and bottom edges.

The default value of this field is 0. weighty should be a non-negative value.

public int
anchor
This field is used when the component is smaller than its display area. It determines where, within the display area, to place the component.

There are three kinds of possible values: orientation relative, baseline relative and absolute. Orientation relative values are interpreted relative to the container's component orientation property, baseline relative values are interpreted relative to the baseline and absolute values are not. The absolute values are: CENTER, NORTH, NORTHEAST, EAST, SOUTHEAST, SOUTH, SOUTHWEST, WEST, and NORTHWEST. The orientation relative values are: PAGE_START, PAGE_END, LINE_START, LINE_END, FIRST_LINE_START, FIRST_LINE_END, LAST_LINE_START and LAST_LINE_END. The baseline relvative values are: BASELINE, BASELINE_LEADING, BASELINE_TRAILING, ABOVE_BASELINE, ABOVE_BASELINE_LEADING, ABOVE_BASELINE_TRAILING, BELOW_BASELINE, BELOW_BASELINE_LEADING, and BELOW_BASELINE_TRAILING. The default value is CENTER.

public int
fill
This field is used when the component's display area is larger than the component's requested size. It determines whether to resize the component, and if so, how.

The following values are valid for fill:

  • NONE: Do not resize the component.
  • HORIZONTAL: Make the component wide enough to fill its display area horizontally, but do not change its height.
  • VERTICAL: Make the component tall enough to fill its display area vertically, but do not change its width.
  • BOTH: Make the component fill its display area entirely.

The default value is NONE.

public Insets
insets
This field specifies the external padding of the component, the minimum amount of space between the component and the edges of its display area.

The default value is new Insets(0, 0, 0, 0).

public int
ipadx
This field specifies the internal padding of the component, how much space to add to the minimum width of the component. The width of the component is at least its minimum width plus ipadx pixels.

The default value is 0.

public int
ipady
This field specifies the internal padding, that is, how much space to add to the minimum height of the component. The height of the component is at least its minimum height plus ipady pixels.

The default value is 0.

int
tempX
Temporary place holder for the x coordinate.
int
tempY
Temporary place holder for the y coordinate.
int
tempWidth
Temporary place holder for the Width of the component.
int
tempHeight
Temporary place holder for the Height of the component.
int
minWidth
The minimum width of the component. It is used to calculate ipady, where the default will be 0.
int
minHeight
The minimum height of the component. It is used to calculate ipadx, where the default will be 0.
transient int
ascent
transient int
descent
transient Component$BaselineResizeBehavior
baselineResizeBehavior
transient int
centerPadding
transient int
centerOffset
private static final long
serialVersionUID
Constructors Summary
public GridBagConstraints()
Creates a GridBagConstraint object with all of its fields set to their default value.


                         
       
        gridx = RELATIVE;
        gridy = RELATIVE;
        gridwidth = 1;
        gridheight = 1;

        weightx = 0;
        weighty = 0;
        anchor = CENTER;
        fill = NONE;

        insets = new Insets(0, 0, 0, 0);
        ipadx = 0;
        ipady = 0;
    
public GridBagConstraints(int gridx, int gridy, int gridwidth, int gridheight, double weightx, double weighty, int anchor, int fill, Insets insets, int ipadx, int ipady)
Creates a GridBagConstraints object with all of its fields set to the passed-in arguments. Note: Because the use of this constructor hinders readability of source code, this constructor should only be used by automatic source code generation tools.

param
gridx The initial gridx value.
param
gridy The initial gridy value.
param
gridwidth The initial gridwidth value.
param
gridheight The initial gridheight value.
param
weightx The initial weightx value.
param
weighty The initial weighty value.
param
anchor The initial anchor value.
param
fill The initial fill value.
param
insets The initial insets value.
param
ipadx The initial ipadx value.
param
ipady The initial ipady value.
see
java.awt.GridBagConstraints#gridx
see
java.awt.GridBagConstraints#gridy
see
java.awt.GridBagConstraints#gridwidth
see
java.awt.GridBagConstraints#gridheight
see
java.awt.GridBagConstraints#weightx
see
java.awt.GridBagConstraints#weighty
see
java.awt.GridBagConstraints#anchor
see
java.awt.GridBagConstraints#fill
see
java.awt.GridBagConstraints#insets
see
java.awt.GridBagConstraints#ipadx
see
java.awt.GridBagConstraints#ipady
since
1.2

        this.gridx = gridx;
        this.gridy = gridy;
        this.gridwidth = gridwidth;
        this.gridheight = gridheight;
        this.fill = fill;
        this.ipadx = ipadx;
        this.ipady = ipady;
        this.insets = insets;
        this.anchor  = anchor;
        this.weightx = weightx;
        this.weighty = weighty;
    
Methods Summary
public java.lang.Objectclone()
Creates a copy of this grid bag constraint.

return
a copy of this grid bag constraint

        try { 
            GridBagConstraints c = (GridBagConstraints)super.clone();
            c.insets = (Insets)insets.clone();
            return c;
        } catch (CloneNotSupportedException e) { 
            // this shouldn't happen, since we are Cloneable
            throw new InternalError();
        }
    
booleanisVerticallyResizable()

        return (fill == BOTH || fill == VERTICAL);