Class BoundSize

  • All Implemented Interfaces:
    java.io.Serializable

    public class BoundSize
    extends java.lang.Object
    implements java.io.Serializable
    A size that contains minimum, preferred and maximum size of type UnitValue.

    This class is a simple value container and it is immutable.

    If a size is missing (i.e., null) that boundary should be considered "not in use".

    You can create a BoundSize from a String with the use of ConstraintParser.parseBoundSize(String, boolean, boolean)

    See Also:
    Serialized Form
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      int constrain​(int size, float refValue, ContainerWrapper parent)
      Makes sure that size is within min and max of this size.
      boolean getGapPush()
      If the size should be hinted as "pushing" and thus want to occupy free space if noone else is claiming it.
      UnitValue getMax()
      Returns the maximum size as sent into the constructor.
      UnitValue getMin()
      Returns the minimum size as sent into the constructor.
      UnitValue getPreferred()
      Returns the preferred size as sent into the constructor.
      boolean isUnset()
      Returns if this bound size has no min, preferred and maximum size set (they are all null)
      protected java.lang.Object readResolve()  
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    • Field Detail

      • NULL_SIZE

        public static final BoundSize NULL_SIZE
      • ZERO_PIXEL

        public static final BoundSize ZERO_PIXEL
    • Constructor Detail

      • BoundSize

        public BoundSize​(UnitValue minMaxPref,
                         java.lang.String createString)
        Constructor that use the same value for min/preferred/max size.
        Parameters:
        minMaxPref - The value to use for min/preferred/max size.
        createString - The string used to create the BoundsSize.
      • BoundSize

        public BoundSize​(UnitValue min,
                         UnitValue preferred,
                         UnitValue max,
                         java.lang.String createString)
        Constructor. This method is here for serilization only and should normally not be used. Use ConstraintParser.parseBoundSize(String, boolean, boolean) instead.
        Parameters:
        min - The minimum size. May be null.
        preferred - The preferred size. May be null.
        max - The maximum size. May be null.
        createString - The string used to create the BoundsSize.
      • BoundSize

        public BoundSize​(UnitValue min,
                         UnitValue preferred,
                         UnitValue max,
                         boolean gapPush,
                         java.lang.String createString)
        Constructor. This method is here for serilization only and should normally not be used. Use ConstraintParser.parseBoundSize(String, boolean, boolean) instead.
        Parameters:
        min - The minimum size. May be null.
        preferred - The preferred size. May be null.
        max - The maximum size. May be null.
        gapPush - If the size should be hinted as "pushing" and thus want to occupy free space if no one else is claiming it.
        createString - The string used to create the BoundsSize.
    • Method Detail

      • getMin

        public final UnitValue getMin()
        Returns the minimum size as sent into the constructor.
        Returns:
        The minimum size as sent into the constructor. May be null.
      • getPreferred

        public final UnitValue getPreferred()
        Returns the preferred size as sent into the constructor.
        Returns:
        The preferred size as sent into the constructor. May be null.
      • getMax

        public final UnitValue getMax()
        Returns the maximum size as sent into the constructor.
        Returns:
        The maximum size as sent into the constructor. May be null.
      • getGapPush

        public boolean getGapPush()
        If the size should be hinted as "pushing" and thus want to occupy free space if noone else is claiming it.
        Returns:
        The value.
      • isUnset

        public boolean isUnset()
        Returns if this bound size has no min, preferred and maximum size set (they are all null)
        Returns:
        If unset.
      • constrain

        public int constrain​(int size,
                             float refValue,
                             ContainerWrapper parent)
        Makes sure that size is within min and max of this size.
        Parameters:
        size - The size to constrain.
        refValue - The reference to use for relative sizes.
        parent - The parent container.
        Returns:
        The size, constrained within min and max.
      • readResolve

        protected java.lang.Object readResolve()
                                        throws java.io.ObjectStreamException
        Throws:
        java.io.ObjectStreamException