com.jgoodies.forms.layout
public final class ColumnSpec extends FormSpec
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 $
See Also: FormFactory
Field Summary | |
---|---|
static DefaultAlignment | CENTER
By default put the components in the center. |
static DefaultAlignment | DEFAULT
Unless overridden the default alignment for a column is FILL. |
static DefaultAlignment | FILL
By default fill the component into the column. |
static DefaultAlignment | LEFT
By default put components in the left. |
static DefaultAlignment | MIDDLE
By default put components in the middle. |
static DefaultAlignment | RIGHT
By default put components in the right. |
Constructor Summary | |
---|---|
ColumnSpec(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
| |
ColumnSpec(Size size)
Constructs a ColumnSpec for the given size using the
default alignment, and no resizing.
| |
ColumnSpec(String encodedDescription)
Constructs a ColumnSpec from the specified encoded description.
|
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. vertical).
|
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
Throws: NullPointerException if the {@code size} is {@code null} IllegalArgumentException if the size is invalid or the {@code resizeWeight} is negative
Parameters: size constant size, component size, or bounded size
Throws: IllegalArgumentException if the size is invalid
Deprecated: Replaced by decode
Constructs a ColumnSpec from the specified encoded description. The description will be parsed to set initial values.Unlike the factory method decode, 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
Parameters: gapWidth specifies the gap width
Returns: a ColumnSpec that describes a horizontal gap
Throws: NullPointerException if {@code gapWidth} is {@code null}
Since: 1.2
Parameters: encodedColumnSpec the encoded column specification
Returns: a ColumnSpec instance for the given specification
Throws: NullPointerException if {@code encodedColumnSpec} is {@code null}
Since: 1.2
See Also: ColumnSpec
Parameters: encodedColumnSpec the encoded column specification layoutMap expands layout column variables
Returns: a ColumnSpec instance for the given specification
Throws: NullPointerException if {@code encodedColumnSpec} or {@code layoutMap} is {@code null}
Since: 1.2
Parameters: encodedColumnSpecs comma separated encoded column specifications
Returns: an array of decoded column specifications
Throws: NullPointerException if {@code encodedColumnSpecs} is {@code null}
See Also: ColumnSpec decode getRoot
Parameters: encodedColumnSpecs comma separated encoded column specifications layoutMap expands layout column variables
Returns: an array of decoded column specifications
Throws: NullPointerException if {@code encodedColumnSpecs} or {@code layoutMap} is {@code null}
Since: 1.2
See Also: decodeSpecs
Returns: always {@code true} (for horizontal)