Class LayoutUtil

java.lang.Object
net.miginfocom.layout.LayoutUtil

public final class LayoutUtil extends Object
A utility class that has only static helper methods.
  • Field Details

    • INF

      public static final int INF
      A substitute value for a really large value. Integer.MAX_VALUE is not used since that means a lot of defensive code for potential overflow must exist in many places. This value is large enough for being unreasonable yet it is hard to overflow.
      See Also:
    • NOT_SET

      static final int NOT_SET
      Tag int for a value that in considered "not set". Used as "null" element in int arrays.
      See Also:
    • MIN

      public static final int MIN
      See Also:
    • PREF

      public static final int PREF
      See Also:
    • MAX

      public static final int MAX
      See Also:
    • HORIZONTAL

      public static final int HORIZONTAL
      See Also:
    • VERTICAL

      public static final int VERTICAL
      See Also:
    • CR_MAP

      private static volatile WeakHashMap<Object,String> CR_MAP
    • DT_MAP

      private static volatile WeakHashMap<Object,Boolean> DT_MAP
    • eSz

      private static int eSz
    • globalDebugMillis

      private static int globalDebugMillis
    • HAS_BEANS

      public static final boolean HAS_BEANS
    • writeOutputStream

      private static ByteArrayOutputStream writeOutputStream
    • readBuf

      private static byte[] readBuf
    • SER_MAP

      private static final IdentityHashMap<Object,Object> SER_MAP
  • Constructor Details

    • LayoutUtil

      private LayoutUtil()
  • Method Details

    • hasBeans

      private static boolean hasBeans()
    • getVersion

      public static String getVersion()
      Returns the current version of MiG Layout.
      Returns:
      The current version of MiG Layout. E.g. "3.6.3" or "4.0"
    • getGlobalDebugMillis

      public static int getGlobalDebugMillis()
      If global debug should be on or off. If > 0 then debug is turned on for all MigLayout instances.
      Returns:
      The current debug milliseconds.
      See Also:
    • setGlobalDebugMillis

      public static void setGlobalDebugMillis(int millis)
      If global debug should be on or off. If > 0 then debug is turned on for all MigLayout instances.

      Note! This is a passive value and will be read by panels when the needed, which is normally when they repaint/layout.

      Parameters:
      millis - The new debug milliseconds. 0 turns of global debug and leaves debug up to every individual panel.
      See Also:
    • setDesignTime

      public static void setDesignTime(ContainerWrapper cw, boolean b)
      Sets if design time is turned on for a Container in ContainerWrapper.
      Parameters:
      cw - The container to set design time for. null is legal and can be used as a key to turn on/off design time "in general". Note though that design time "in general" is always on as long as there is at least one ContainerWrapper with design time.

      If this method has not ever been called it will default to what Beans.isDesignTime() returns. This means that if you call this method you indicate that you will take responsibility for the design time value.

      b - true means design time on.
    • isDesignTime

      public static boolean isDesignTime(ContainerWrapper cw)
      Returns if design time is turned on for a Container in ContainerWrapper.
      Parameters:
      cw - The container to set design time for. null is legal will return true if there is at least one ContainerWrapper (or null) that have design time turned on.
      Returns:
      If design time is set for cw.
    • getDesignTimeEmptySize

      public static int getDesignTimeEmptySize()
      The size of an empty row or columns in a grid during design time.
      Returns:
      The number of pixels. Default is 15.
    • setDesignTimeEmptySize

      public static void setDesignTimeEmptySize(int pixels)
      The size of an empty row or columns in a grid during design time.
      Parameters:
      pixels - The number of pixels. Default is 0 (it was 15 prior to v3.7.2, but since that meant different behaviour under design time by default it was changed to be 0, same as non-design time). IDE vendors can still set it to 15 to get the old behaviour.
    • putCCString

      static void putCCString(Object con, String s)
      Associates con with the creation string s. The con object should probably have an equals method that compares identities or con objects that .equals() will only be able to have one creation string.

      If isDesignTime(ContainerWrapper) returns false the method does nothing.

      Parameters:
      con - The object. if null the method does nothing.
      s - The creation string. if null the method does nothing.
    • setDelegate

      static void setDelegate(Class<?> c, PersistenceDelegate del)
      Sets/add the persistence delegates to be used for a class.
      Parameters:
      c - The class to set the registered delegate for.
      del - The new delegate or null to erase to old one.
    • getCCString

      static String getCCString(Object con)
      Returns strings set with putCCString(Object, String) or null if nothing is associated or isDesignTime(ContainerWrapper) returns false.
      Parameters:
      con - The constrain object.
      Returns:
      The creation string or null if nothing is registered with the con object.
    • throwCC

      static void throwCC()
    • calculateSerial

      static int[] calculateSerial(int[][] sizes, ResizeConstraint[] resConstr, Float[] defPushWeights, int startSizeType, int bounds)
      Takes a number on min/preferred/max sizes and resize constraints and returns the calculated sizes which sum should add up to bounds. Whether the sum will actually equal bounds is dependent on the pref/max sizes and resize constraints.
      Parameters:
      sizes - [ix],[MIN][PREF][MAX]. Grid.CompWrap.NOT_SET will be treated as N/A or 0. A "[MIN][PREF][MAX]" array with null elements will be interpreted as very flexible (no bounds) but if the array itself is null it will not get any size.
      resConstr - Elements can be null and the whole array can be null. null means that the size will not be flexible at all. Can have length less than sizes in which case the last element should be used for the elements missing.
      defPushWeights - If there is no grow weight for a resConstr the corresponding value of this array is used. These forced resConstr will be grown last though and only if needed to fill to the bounds.
      startSizeType - The initial size to use. E.g. MIN.
      bounds - To use for relative sizes.
      Returns:
      The sizes. Array length will match sizes.
    • getIndexSafe

      static Object getIndexSafe(Object[] arr, int ix)
    • getBrokenBoundary

      private static int getBrokenBoundary(float sz, int lower, int upper)
      Returns the broken boundary if sz is outside the boundaries lower or upper. If both boundaries are broken, the lower one is returned. If sz is < 0 then new Float(0f) is returned so that no sizes can be negative.
      Parameters:
      sz - The size to check
      lower - The lower boundary (or null for no boundary).
      upper - The upper boundary (or null for no boundary).
      Returns:
      The broken boundary.
    • sum

      static int sum(int[] terms, int start, int len)
    • sum

      static int sum(int[] terms)
    • clamp

      static float clamp(float f, float min, float max)
      Keeps f within min and max. Min is of higher priority if min is larger than max.
      Parameters:
      f - The value to clamp
      min -
      max -
      Returns:
      The clamped value, between min and max.
    • clamp

      static int clamp(int i, int min, int max)
      Keeps i within min and max. Min is of higher priority if min is larger than max.
      Parameters:
      i - The value to clamp
      min -
      max -
      Returns:
      The clamped value, between min and max.
    • getSizeSafe

      public static int getSizeSafe(int[] sizes, int sizeType)
    • derive

      static BoundSize derive(BoundSize bs, UnitValue min, UnitValue pref, UnitValue max)
    • isLeftToRight

      public static boolean isLeftToRight(LC lc, ContainerWrapper container)
      Returns if left-to-right orientation is used. If not set explicitly in the layout constraints the Locale of the parent is used.
      Parameters:
      lc - The constraint if there is one. Can be null.
      container - The parent that may be used to get the left-to-right if lc does not specify this.
      Returns:
      If left-to-right orientation is currently used.
    • roundSizes

      static int[] roundSizes(float[] sizes)
      Round a number of float sizes into int sizes so that the total length match up
      Parameters:
      sizes - The sizes to round
      Returns:
      An array of equal length as sizes.
    • equals

      static boolean equals(Object o1, Object o2)
      Safe equals. null == null, but null never equals anything else.
      Parameters:
      o1 - The first object. May be null.
      o2 - The second object. May be null.
      Returns:
      Returns true if o1 and o2 are equal (using .equals()) or both are null.
    • getInsets

      static UnitValue getInsets(LC lc, int side, boolean getDefault)
      Returns the insets for the side.
      Parameters:
      side - top == 0, left == 1, bottom = 2, right = 3.
      getDefault - If true the default insets will get retrieved if lc has none set.
      Returns:
      The insets for the side. Never null.
    • writeXMLObject

      static void writeXMLObject(OutputStream os, Object o, ExceptionListener listener)
      Writes the object and CLOSES the stream. Uses the persistence delegate registered in this class.
      Parameters:
      os - The stream to write to. Will be closed.
      o - The object to be serialized.
      listener - The listener to receive the exceptions if there are any. If null not used.
    • writeAsXML

      public static void writeAsXML(ObjectOutput out, Object o) throws IOException
      Writes an object to XML.
      Parameters:
      out - The object out to write to. Will not be closed.
      o - The object to write.
      Throws:
      IOException
    • readAsXML

      public static Object readAsXML(ObjectInput in) throws IOException
      Reads an object from in using the
      Parameters:
      in - The object input to read from.
      Returns:
      The object. Never null.
      Throws:
      IOException - If there was a problem saving as XML
    • setSerializedObject

      public static void setSerializedObject(Object caller, Object o)
      Sets the serialized object and associates it with caller.
      Parameters:
      caller - The object created o
      o - The just serialized object.
    • getSerializedObject

      public static Object getSerializedObject(Object caller)
      Returns the serialized object that are associated with caller. It also removes it from the list.
      Parameters:
      caller - The original creator of the object.
      Returns:
      The object.