com.jgoodies.forms.layout
Class ColumnSpec
- Serializable
public final class ColumnSpec
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.
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.
|
ColumnSpec
public ColumnSpec(String encodedDescription)
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.
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.
defaultAlignment
- the column's default alignmentsize
- constant, component size or bounded sizeresizeWeight
- 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.
size
- constant size, component size, or bounded size
createGap
public static ColumnSpec createGap(ConstantSize gapWidth)
gapWidth
- specifies the gap width
- a ColumnSpec that describes a horizontal gap
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.
encodedColumnSpec
- the encoded column specification
- a ColumnSpec instance for the given specification
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.
encodedColumnSpec
- the encoded column specificationlayoutMap
- expands layout column variables
- a ColumnSpec instance for the given specification
decodeSpecs
public static ColumnSpec[] decodeSpecs(String encodedColumnSpecs)
Parses and splits encoded column specifications using the default
LayoutMap
and returns an array of ColumnSpec objects.
encodedColumnSpecs
- comma separated encoded column specifications
- 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.
encodedColumnSpecs
- comma separated encoded column specificationslayoutMap
- expands layout column variables
- an array of decoded column specifications
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.
- always
true
(for horizontal)
Copyright © 2002-2008 JGoodies Karsten Lentzsch. All Rights Reserved.