com.jgoodies.forms.layout

Class ColumnSpec

Implemented Interfaces:
Serializable

public final class ColumnSpec
extends FormSpec

Specifies columns in FormLayout by their default orientation, start size and resizing behavior.

Examples:
The following examples specify a column with FILL alignment, a size of 10 dlu that won't grow.

 new ColumnSpec(Sizes.dluX(10));
 new ColumnSpec(ColumnSpec.FILL, Sizes.dluX(10), 0.0);
 new ColumnSpec(ColumnSpec.FILL, Sizes.dluX(10), ColumnSpec.NO_GROW);
 ColumnSpec.parse("10dlu");
 ColumnSpec.parse("10dlu:0");
 ColumnSpec.parse("fill:10dlu:0");
 

The FormFactory provides predefined frequently used ColumnSpec instances.

Version:
$Revision: 1.15 $
Author:
Karsten Lentzsch
See Also:
FormFactory

Nested Class Summary

Nested classes/interfaces inherited from class com.jgoodies.forms.layout.FormSpec

FormSpec.DefaultAlignment

Field Summary

static FormSpec.DefaultAlignment
CENTER
By default put the components in the center.
static FormSpec.DefaultAlignment
DEFAULT
Unless overridden the default alignment for a column is FILL.
static FormSpec.DefaultAlignment
FILL
By default fill the component into the column.
static FormSpec.DefaultAlignment
LEFT
By default put components in the left.
static FormSpec.DefaultAlignment
MIDDLE
By default put components in the middle.
static FormSpec.DefaultAlignment
RIGHT
By default put components in the right.

Fields inherited from class com.jgoodies.forms.layout.FormSpec

DEFAULT_GROW, NO_GROW

Constructor Summary

ColumnSpec(String encodedDescription)
Deprecated. Replaced by decode(String)
ColumnSpec(FormSpec.DefaultAlignment defaultAlignment, Size size, double resizeWeight)
Constructs a ColumnSpec for the given default alignment, size and resize weight.
ColumnSpec(Size size)
Constructs a ColumnSpec for the given size using the default alignment, and no resizing.

Method Summary

static ColumnSpec
createGap(ConstantSize gapWidth)
Creates and returns a ColumnSpec that represents a gap with the specified ConstantSize.
static ColumnSpec
decode(String encodedColumnSpec)
Parses the encoded column specification and returns a ColumnSpec object that represents the string.
static ColumnSpec
decode(String encodedColumnSpec, LayoutMap layoutMap)
Parses the encoded column specifications and returns a ColumnSpec object that represents the string.
static ColumnSpec[]
decodeSpecs(String encodedColumnSpecs)
Parses and splits encoded column specifications using the default LayoutMap and returns an array of ColumnSpec objects.
static ColumnSpec[]
decodeSpecs(String encodedColumnSpecs, LayoutMap layoutMap)
Splits and parses the encoded column specifications using the given LayoutMap and returns an array of ColumnSpec objects.
protected boolean
isHorizontal()
Returns if this is a horizontal specification (vs.

Methods inherited from class com.jgoodies.forms.layout.FormSpec

encode, getDefaultAlignment, getResizeWeight, getSize, toShortString, toString

Field Details

CENTER

public static final FormSpec.DefaultAlignment CENTER
By default put the components in the center.

DEFAULT

public static final FormSpec.DefaultAlignment DEFAULT
Unless overridden the default alignment for a column is FILL.

FILL

public static final FormSpec.DefaultAlignment FILL
By default fill the component into the column.

LEFT

public static final FormSpec.DefaultAlignment LEFT
By default put components in the left.

MIDDLE

public static final FormSpec.DefaultAlignment MIDDLE
By default put components in the middle.

RIGHT

public static final FormSpec.DefaultAlignment RIGHT
By default put components in the right.

Constructor Details

ColumnSpec

public ColumnSpec(String encodedDescription)

Deprecated. Replaced by decode(String)

Constructs a ColumnSpec from the specified encoded description. The description will be parsed to set initial values.

Unlike the factory method decode(String), this constructor does not expand layout variables, and it cannot vend cached objects.

Note: This constructor will become private in the Forms 2.0.

Parameters:
encodedDescription - the encoded description

ColumnSpec

public ColumnSpec(FormSpec.DefaultAlignment defaultAlignment,
                  Size size,
                  double resizeWeight)
Constructs a ColumnSpec for the given default alignment, size and resize weight.

The resize weight must be a non-negative double; you can use NO_GROW as a convenience value for no resize.

Parameters:
defaultAlignment - the column's default alignment
size - constant, component size or bounded size
resizeWeight - the column's non-negative resize weight

ColumnSpec

public ColumnSpec(Size size)
Constructs a ColumnSpec for the given size using the default alignment, and no resizing.
Parameters:
size - constant size, component size, or bounded size

Method Details

createGap

public static ColumnSpec createGap(ConstantSize gapWidth)
Creates and returns a ColumnSpec that represents a gap with the specified ConstantSize.
Parameters:
gapWidth - specifies the gap width
Returns:
a ColumnSpec that describes a horizontal gap
Since:
1.2

decode

public static ColumnSpec decode(String encodedColumnSpec)
Parses the encoded column specification and returns a ColumnSpec object that represents the string. Variables are expanded using the default LayoutMap.
Parameters:
encodedColumnSpec - the encoded column specification
Returns:
a ColumnSpec instance for the given specification
Since:
1.2

decode

public static ColumnSpec decode(String encodedColumnSpec,
                                LayoutMap layoutMap)
Parses the encoded column specifications and returns a ColumnSpec object that represents the string. Variables are expanded using the given LayoutMap.
Parameters:
encodedColumnSpec - the encoded column specification
layoutMap - expands layout column variables
Returns:
a ColumnSpec instance for the given specification
Since:
1.2

decodeSpecs

public static ColumnSpec[] decodeSpecs(String encodedColumnSpecs)
Parses and splits encoded column specifications using the default LayoutMap and returns an array of ColumnSpec objects.
Parameters:
encodedColumnSpecs - comma separated encoded column specifications
Returns:
an array of decoded column specifications

decodeSpecs

public static ColumnSpec[] decodeSpecs(String encodedColumnSpecs,
                                       LayoutMap layoutMap)
Splits and parses the encoded column specifications using the given LayoutMap and returns an array of ColumnSpec objects.
Parameters:
encodedColumnSpecs - comma separated encoded column specifications
layoutMap - expands layout column variables
Returns:
an array of decoded column specifications
Since:
1.2

isHorizontal

protected boolean isHorizontal()
Returns if this is a horizontal specification (vs. vertical). Used to distinct between horizontal and vertical dialog units, which have different conversion factors.
Returns:
always true (for horizontal)

Copyright © 2002-2008 JGoodies Karsten Lentzsch. All Rights Reserved.