com.jgoodies.forms.layout

Class RowSpec

Implemented Interfaces:
Serializable

public final class RowSpec
extends FormSpec

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

Examples:
The following examples specify a centered row with a size of 14 dlu that won't grow.

 new RowSpec(Sizes.dluX(14));
 new RowSpec(RowSpec.CENTER, Sizes.dluX(14), 0.0);
 new RowSpec(rowSpec.CENTER, Sizes.dluX(14), RowSpec.NO_GROW);
 RowSpec.parse("14dlu");
 RowSpec.parse("14dlu:0");
 RowSpec.parse("center:14dlu:0");
 

The FormFactory provides predefined frequently used RowSpec 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
BOTTOM
By default put the components in the bottom.
static FormSpec.DefaultAlignment
CENTER
By default put the components in the center.
static FormSpec.DefaultAlignment
DEFAULT
Unless overridden the default alignment for a row is CENTER.
static FormSpec.DefaultAlignment
FILL
By default fill the component into the row.
static FormSpec.DefaultAlignment
TOP
By default put the components in the top.

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

DEFAULT_GROW, NO_GROW

Constructor Summary

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

Method Summary

static RowSpec
createGap(ConstantSize gapHeight)
Creates and returns a RowSpec that represents a gap with the specified ConstantSize.
static RowSpec
decode(String encodedRowSpec)
Parses the encoded row specification and returns a RowSpec object that represents the string.
static RowSpec
decode(String encodedRowSpec, LayoutMap layoutMap)
Parses the encoded row specifications and returns a RowSpec object that represents the string.
static RowSpec[]
decodeSpecs(String encodedRowSpecs)
Parses and splits encoded row specifications using the default LayoutMap and returns an array of RowSpec objects.
static RowSpec[]
decodeSpecs(String encodedRowSpecs, LayoutMap layoutMap)
Parses and splits encoded row specifications using the given LayoutMap and returns an array of RowSpec 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

BOTTOM

public static final FormSpec.DefaultAlignment BOTTOM
By default put the components in the bottom.

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 row is CENTER.

FILL

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

TOP

public static final FormSpec.DefaultAlignment TOP
By default put the components in the top.

Constructor Details

RowSpec

public RowSpec(String encodedDescription)

Deprecated. Replaced by decode(String).

Constructs a RowSpec 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

RowSpec

public RowSpec(FormSpec.DefaultAlignment defaultAlignment,
               Size size,
               double resizeWeight)
Constructs a RowSpec from the given default orientation, size, and resize weight.

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

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

RowSpec

public RowSpec(Size size)
Constructs a RowSpec 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 RowSpec createGap(ConstantSize gapHeight)
Creates and returns a RowSpec that represents a gap with the specified ConstantSize.
Parameters:
gapHeight - specifies the gap height
Returns:
a RowSpec that describes a vertical gap with the given height
Since:
1.2

decode

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

decode

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

decodeSpecs

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

decodeSpecs

public static RowSpec[] decodeSpecs(String encodedRowSpecs,
                                    LayoutMap layoutMap)
Parses and splits encoded row specifications using the given LayoutMap and returns an array of RowSpec objects.
Parameters:
encodedRowSpecs - comma separated encoded row specifications
layoutMap - expands layout row variables
Returns:
an array of decoded row 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 false (for vertical)

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