Package com.jgoodies.forms.layout

Class FormSpec

  • All Implemented Interfaces:
    java.io.Serializable
    Direct Known Subclasses:
    ColumnSpec, RowSpec
    public abstract class FormSpec
extends java.lang.Object
implements java.io.Serializable
    An abstract class that specifies columns and rows in FormLayout by their default alignment, start size and resizing behavior. API users will use the subclasses ColumnSpec and RowSpec.
    Version:
    $Revision$
    Author:
    Karsten Lentzsch
    See Also:
    ColumnSpec, RowSpec, FormLayout, CellConstraints, Serialized Form

    • Nested Class Summary

      Nested Classes 
      Modifier and Type Class Description
      static class  FormSpec.DefaultAlignment
      An ordinal-based serializable typesafe enumeration for the column and row default alignment types.

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static double DEFAULT_GROW
      The default resize weight.
      static double NO_GROW
      Gives a column or row a fixed size.

    • Constructor Summary

      Constructors 
      Modifier Constructor Description
      protected FormSpec​(FormSpec.DefaultAlignment defaultAlignment, Size size, double resizeWeight)
      Constructs a FormSpec for the given default alignment, size, and resize weight.
      protected FormSpec​(FormSpec.DefaultAlignment defaultAlignment, java.lang.String encodedDescription)
      Constructs a FormSpec from the specified encoded description.

    • Field Detail

      • NO_GROW

        public static final double NO_GROW
        Gives a column or row a fixed size.
        See Also:
        Constant Field Values

      • DEFAULT_GROW

        public static final double DEFAULT_GROW
        The default resize weight.
        See Also:
        Constant Field Values

    • Constructor Detail

      • FormSpec

        protected FormSpec​(FormSpec.DefaultAlignment defaultAlignment,
                   Size size,
                   double resizeWeight)
        Constructs a FormSpec for the given default alignment, size, and resize weight. The resize weight must be a non-negative double; you can use NONE as a convenience value for no resize.
        Parameters:
        defaultAlignment - the spec's default alignment
        size - a constant, component or bounded size
        resizeWeight - the spec resize weight
        Throws:
        java.lang.IllegalArgumentException - if the resize weight is negative

      • FormSpec

        protected FormSpec​(FormSpec.DefaultAlignment defaultAlignment,
                   java.lang.String encodedDescription)
        Constructs a FormSpec from the specified encoded description. The description will be parsed to set initial values.
        Parameters:
        defaultAlignment - the default alignment
        encodedDescription - the encoded description

    • Method Detail

      • getDefaultAlignment

        public final FormSpec.DefaultAlignment getDefaultAlignment()
        Returns the default alignment.
        Returns:
        the default alignment

      • getSize

        public final Size getSize()
        Returns the size.
        Returns:
        the size

      • getResizeWeight

        public final double getResizeWeight()
        Returns the current resize weight.
        Returns:
        the resize weight.

      • toString

        public final java.lang.String toString()
        Returns a string representation of this form specification. The string representation consists of three elements separated by a colon (":"), first the alignment, second the size, and third the resize spec.

        This method does not return a decoded version of this object; the contrary is the case. Many instances will return a string that cannot be parsed.

        Note: The string representation may change at any time. It is strongly recommended to not use this string for parsing purposes.

        Overrides:
        toString in class java.lang.Object
        Returns:
        a string representation of the form specification.

      • toShortString

        public final java.lang.String toShortString()
        Returns a string representation of this form specification. The string representation consists of three elements separated by a colon (":"), first the alignment, second the size, and third the resize spec.

        This method does not return a decoded version of this object; the contrary is the case. Many instances will return a string that cannot be parsed.

        Note: The string representation may change at any time. It is strongly recommended to not use this string for parsing purposes.

        Returns:
        a string representation of the form specification.