net.miginfocom.layout

Class LC

public final class LC extends Object implements Externalizable

Contains the constraints for an instance of the LC layout manager.
Constructor Summary
LC()
Empty constructor.
Method Summary
LCalign(String ax, String ay)
Sets both the alignX and alignY as the same time.
LCalignX(String align)
Same functionality as setAlignX(ConstraintParser.parseUnitValueOrAlign(unitValue, true)) only this method returns this for chaining multiple calls.
LCalignY(String align)
Same functionality as setAlignY(ConstraintParser.parseUnitValueOrAlign(align, false)) only this method returns this for chaining multiple calls.
LCbottomToTop()
Same functionality as LC only this method returns this for chaining multiple calls.
LCdebug(int repaintMillis)
Same functionality as LC only this method returns this for chaining multiple calls.
LCfill()
Same functionality as LC and LC conmbined.T his method returns this for chaining multiple calls.
LCfillX()
Same functionality as LC only this method returns this for chaining multiple calls.
LCfillY()
Same functionality as LC only this method returns this for chaining multiple calls.
LCflowX()
Same functionality as LC only this method returns this for chaining multiple calls.
LCflowY()
Same functionality as LC only this method returns this for chaining multiple calls.
UnitValuegetAlignX()
If the laid out components' bounds in total is less than the final size of the container these align values will be used to align the components in the parent.
UnitValuegetAlignY()
If the laid out components' bounds in total is less than the final size of the container these align values will be used to align the components in the parent.
intgetDebugMillis()
If > 0 the debug decorations will be repainted every millis.
BoundSizegetGridGapX()
If non-null (null is default) these value will be used as the default gaps between the columns in the grid.
BoundSizegetGridGapY()
If non-null (null is default) these value will be used as the default gaps between the rows in the grid.
BoundSizegetHeight()
Returns the minimum/preferred/maximum size for the container that this layout constraint is set for.
intgetHideMode()
How a component that is hidden (not visible) should be treated by default.
UnitValue[]getInsets()
The insets for the layed out panel.
BooleangetLeftToRight()
If the layout should be forced to be left-to-right or right-to-left.
BoundSizegetPackHeight()
Returns the "pack height" for the window that this container is located in.
floatgetPackHeightAlign()
If there is a resize of the window due to packing (see setPackHeight this value, which is between 0f and 1f, decides where the extra/surpurflous size is placed.
BoundSizegetPackWidth()
Returns the "pack width" for the window that this container is located in.
floatgetPackWidthAlign()
If there is a resize of the window due to packing (see setPackHeight this value, which is between 0f and 1f, decides where the extra/surpurflous size is placed.
BoundSizegetWidth()
Returns the minimum/preferred/maximum size for the container that this layout constraint is set for.
intgetWrapAfter()
Returns after what cell the grid should always auto wrap.
LCgridGap(String gapx, String gapy)
Sets both grid gaps at the same time. see gridGapX and gridGapY.
LCgridGapX(String boundsSize)
Same functionality as setGridGapX(ConstraintParser.parseBoundSize(boundsSize, true, true)) only this method returns this for chaining multiple calls.
LCgridGapY(String boundsSize)
Same functionality as setGridGapY(ConstraintParser.parseBoundSize(boundsSize, true, false)) only this method returns this for chaining multiple calls.
LCheight(String height)
The height for the container as a min and/or preferref and/or maximum height.
LChideMode(int mode)
Same functionality as LC only this method returns this for chaining multiple calls.
LCinsets(String s)
Same functionality as setInsets(ConstraintParser.parseInsets(s, true)).
LCinsets(String top, String left, String bottom, String right)
Sets the different insets (expressed as a UnitValues, e.g.
LCinsetsAll(String allSides)
Sets the same inset (expressed as a UnitValue, e.g.
booleanisFillX()
If the layout should always claim the whole bounds of the laid out container even if the preferred size is smaller.
booleanisFillY()
If the layout should always claim the whole bounds of the laid out container even if the preferred size is smaller.
booleanisFlowX()
The default flow direction.
booleanisNoCache()
If components have sizes or positions linked to the bounds of the parent in some way (as for instance the "%" unit has) the cache must be turned off for the panel.
booleanisNoGrid()
If the whole layout should be non grid based.
booleanisTopToBottom()
If the layout should go from the default top-to-bottom in the grid instead of the optinal bottom-to-top.
booleanisVisualPadding()
If visual padding should be automatically used and compensated for by this layout instance.
LCleftToRight(boolean b)
Same functionality as setLeftToRight only this method returns this for chaining multiple calls.
LCmaxHeight(String height)
The maximum height for the container.
LCmaxWidth(String width)
The maximum width for the container.
LCminHeight(String height)
The minimum height for the container.
LCminWidth(String width)
The minimum width for the container.
LCnoCache()
Same functionality as LC only this method returns this for chaining multiple calls.
LCnoGrid()
Same functionality as LC only this method returns this for chaining multiple calls.
LCnoVisualPadding()
Same functionality as LC only this method returns this for chaining multiple calls.
LCpack()
Short for, and thus same as, .pack("pref", "pref").
LCpack(String width, String height)
Sets the pack width and height.
LCpackAlign(float alignX, float alignY)
Sets the pack width and height alignment.
voidreadExternal(ObjectInput in)
LCrightToLeft()
Same functionality as setLeftToRight(false) only this method returns this for chaining multiple calls.
voidsetAlignX(UnitValue uv)
If the laid out components' bounds in total is less than the final size of the container these align values will be used to align the components in the parent.
voidsetAlignY(UnitValue uv)
If the laid out components' bounds in total is less than the final size of the container these align values will be used to align the components in the parent.
voidsetDebugMillis(int millis)
If > 0 the debug decorations will be repainted every millis.
voidsetFillX(boolean b)
If the layout should always claim the whole bounds of the laid out container even if the preferred size is smaller.
voidsetFillY(boolean b)
If the layout should always claim the whole bounds of the laid out container even if the preferred size is smaller.
voidsetFlowX(boolean b)
The default flow direction.
voidsetGridGapX(BoundSize x)
If non-null (null is default) these value will be used as the default gaps between the columns in the grid.
voidsetGridGapY(BoundSize y)
If non-null (null is default) these value will be used as the default gaps between the rows in the grid.
voidsetHeight(BoundSize size)
Sets the minimum/preferred/maximum size for the container that this layout constraint is set for.
voidsetHideMode(int mode)
How a component that is hidden (not visible) should be treated.
voidsetInsets(UnitValue[] ins)
The insets for the layed out panel.
voidsetLeftToRight(Boolean b)
If the layout should be forced to be left-to-right or right-to-left.
voidsetNoCache(boolean b)
If components have sizes or positions linked to the bounds of the parent in some way (as for instance the "%" unit has) the cache must be turned off for the panel.
voidsetNoGrid(boolean b)
If the whole layout should be non grid based.
voidsetPackHeight(BoundSize size)
Sets the "pack height" for the window that this container is located in.
voidsetPackHeightAlign(float align)
If there is a resize of the window due to packing (see setPackHeight this value, which is between 0f and 1f, decides where the extra/surpurflous size is placed.
voidsetPackWidth(BoundSize size)
Sets the "pack width" for the window that this container is located in.
voidsetPackWidthAlign(float align)
If there is a resize of the window due to packing (see setPackHeight this value, which is between 0f and 1f, decides where the extra/surpurflous size is placed.
voidsetTopToBottom(boolean b)
If the layout should go from the default top-to-bottom in the grid instead of the optinal bottom-to-top.
voidsetVisualPadding(boolean b)
If visual padding should be automatically used and compensated for by this layout instance.
voidsetWidth(BoundSize size)
Sets the minimum/preferred/maximum size for the container that this layout constraint is set for.
voidsetWrapAfter(int count)
Sets after what cell the grid should always auto wrap.
LCtopToBottom()
Same functionality as LC only this method returns this for chaining multiple calls.
LCwidth(String width)
The width for the container as a min and/or preferref and/or maximum width.
LCwrap()
Sets a wrap after the number of columns/rows that is defined in the AC.
LCwrapAfter(int count)
Same functionality as LC only this method returns this for chaining multiple calls.
voidwriteExternal(ObjectOutput out)

Constructor Detail

LC

public LC()
Empty constructor.

Method Detail

align

public final LC align(String ax, String ay)
Sets both the alignX and alignY as the same time.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Parameters: ax The align keyword or for instance "100px". E.g "left", "right", "leading" or "trailing". ay The align keyword or for instance "100px". E.g "top" or "bottom".

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

See Also: alignX alignY

alignX

public final LC alignX(String align)
Same functionality as setAlignX(ConstraintParser.parseUnitValueOrAlign(unitValue, true)) only this method returns this for chaining multiple calls.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Parameters: align The align keyword or for instance "100px". E.g "left", "right", "leading" or "trailing".

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

See Also: setAlignX

alignY

public final LC alignY(String align)
Same functionality as setAlignY(ConstraintParser.parseUnitValueOrAlign(align, false)) only this method returns this for chaining multiple calls.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Parameters: align The align keyword or for instance "100px". E.g "top" or "bottom".

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

See Also: setAlignY

bottomToTop

public final LC bottomToTop()
Same functionality as LC only this method returns this for chaining multiple calls.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

debug

public final LC debug(int repaintMillis)
Same functionality as LC only this method returns this for chaining multiple calls.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Parameters: repaintMillis The new debug repaint interval.

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

See Also: LC

fill

public final LC fill()
Same functionality as LC and LC conmbined.T his method returns this for chaining multiple calls.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

fillX

public final LC fillX()
Same functionality as LC only this method returns this for chaining multiple calls.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

fillY

public final LC fillY()
Same functionality as LC only this method returns this for chaining multiple calls.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

flowX

public final LC flowX()
Same functionality as LC only this method returns this for chaining multiple calls.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

flowY

public final LC flowY()
Same functionality as LC only this method returns this for chaining multiple calls.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

getAlignX

public final UnitValue getAlignX()
If the laid out components' bounds in total is less than the final size of the container these align values will be used to align the components in the parent. null is default and that means top/left alignment. The relative distances between the components will not be affected by this property.

Returns: The current alignment.

getAlignY

public final UnitValue getAlignY()
If the laid out components' bounds in total is less than the final size of the container these align values will be used to align the components in the parent. null is default and that means top/left alignment. The relative distances between the components will not be affected by this property.

Returns: The current alignment.

getDebugMillis

public final int getDebugMillis()
If > 0 the debug decorations will be repainted every millis. No debug information if <= 0 (default).

Returns: The current debug repaint interval.

getGridGapX

public final BoundSize getGridGapX()
If non-null (null is default) these value will be used as the default gaps between the columns in the grid.

Returns: The default grid gap between columns in the grid. null if the platform default is used.

getGridGapY

public final BoundSize getGridGapY()
If non-null (null is default) these value will be used as the default gaps between the rows in the grid.

Returns: The default grid gap between rows in the grid. null if the platform default is used.

getHeight

public final BoundSize getHeight()
Returns the minimum/preferred/maximum size for the container that this layout constraint is set for. Any of these sizes that is not null will be returned directly instead of determining the correspondig size through asking the components in this container.

Returns: The height for the container that this layout constraint is set for. Not null but all sizes can be null.

Since: 3.5

getHideMode

public final int getHideMode()
How a component that is hidden (not visible) should be treated by default.

Returns: The mode:
0 == Normal. Bounds will be caclulated as if the component was visible.
1 == If hidden the size will be 0, 0 but the gaps remain.
2 == If hidden the size will be 0, 0 and gaps set to zero.
3 == If hidden the component will be disregarded completely and not take up a cell in the grid..

getInsets

public final UnitValue[] getInsets()
The insets for the layed out panel. The insets will be an empty space around the components in the panel. null values means that the default panel insets for the platform is used. See PlatformDefaults.

Returns: The insets. Of length 4 (top, left, bottom, right) or null. The elements (1 to 4) may be null. The array is a copy and can be used freely.

See Also: ConstraintParser

getLeftToRight

public final Boolean getLeftToRight()
If the layout should be forced to be left-to-right or right-to-left. A value of null is default and means that this will be picked up from the java.util.Locale that the container being layed out is reporting.

Returns: Boolean.TRUE if force left-to-right. Boolean.FALSE if force tight-to-left. null for the default "let the current Locale decide".

getPackHeight

public final BoundSize getPackHeight()
Returns the "pack height" for the window that this container is located in. When the size of this container changes the size of the window will be corrected to be within this BoundsSize. It can be used to set the minimum and/or maximum size of the window as well as the size window should optimally get. This optimal size is normaly its "preferred" size which is why "preferred" is the normal value to set here.

":push" can be appended to the bound size to only push the size bigger and never shrink it if the preferred size gets smaller.

E.g. "pref", "100:pref", "pref:700", "300::700", "pref:push"

Returns: The current value. Never null. Check if not set with .isUnset().

Since: 3.5

getPackHeightAlign

public final float getPackHeightAlign()
If there is a resize of the window due to packing (see setPackHeight this value, which is between 0f and 1f, decides where the extra/surpurflous size is placed. 0f means that the window will resize so that the upper part moves up and the lower side stays in the same place. 0.5f will expand/reduce the window equally upwards and downwards. 1f will do the opposite of 0f of course.

Returns: The pack alignment. Always between 0f and 1f, inclusive.

Since: 3.5

getPackWidth

public final BoundSize getPackWidth()
Returns the "pack width" for the window that this container is located in. When the size of this container changes the size of the window will be corrected to be within this BoundsSize. It can be used to set the minimum and/or maximum size of the window as well as the size window should optimally get. This optimal size is normaly its "preferred" size which is why "preferred" is the normal value to set here.

":push" can be appended to the bound size to only push the size bigger and never shrink it if the preferred size gets smaller.

E.g. "pref", "100:pref", "pref:700", "300::700", "pref:push"

Returns: The current value. Never null. Check if not set with .isUnset().

Since: 3.5

getPackWidthAlign

public final float getPackWidthAlign()
If there is a resize of the window due to packing (see setPackHeight this value, which is between 0f and 1f, decides where the extra/surpurflous size is placed. 0f means that the window will resize so that the left part moves left and the right side stays in the same place. 0.5f will expand/reduce the window equally to the right and lefts. 1f will do the opposite of 0f of course.

Returns: The pack alignment. Always between 0f and 1f, inclusive.

Since: 3.5

getWidth

public final BoundSize getWidth()
Returns the minimum/preferred/maximum size for the container that this layout constraint is set for. Any of these sizes that is not null will be returned directly instead of determining the correspondig size through asking the components in this container.

Returns: The width for the container that this layout constraint is set for. Not null but all sizes can be null.

Since: 3.5

getWrapAfter

public final int getWrapAfter()
Returns after what cell the grid should always auto wrap.

Returns: After what cell the grid should always auto wrap. If 0 the number of columns/rows in the AC is used. LayoutUtil.INF is used for no auto wrap.

gridGap

public final LC gridGap(String gapx, String gapy)
Sets both grid gaps at the same time. see gridGapX and gridGapY.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Parameters: gapx The BoundSize of the gap. This is a minimum and/or preferred and/or maximum size. E.g. "50:100:200" or "100px". gapy The BoundSize of the gap. This is a minimum and/or preferred and/or maximum size. E.g. "50:100:200" or "100px".

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

See Also: gridGapX gridGapY

gridGapX

public final LC gridGapX(String boundsSize)
Same functionality as setGridGapX(ConstraintParser.parseBoundSize(boundsSize, true, true)) only this method returns this for chaining multiple calls.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Parameters: boundsSize The BoundSize of the gap. This is a minimum and/or preferred and/or maximum size. E.g. "50:100:200" or "100px".

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

See Also: setGridGapX

gridGapY

public final LC gridGapY(String boundsSize)
Same functionality as setGridGapY(ConstraintParser.parseBoundSize(boundsSize, true, false)) only this method returns this for chaining multiple calls.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Parameters: boundsSize The BoundSize of the gap. This is a minimum and/or preferred and/or maximum size. E.g. "50:100:200" or "100px".

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

See Also: setGridGapY

height

public final LC height(String height)
The height for the container as a min and/or preferref and/or maximum height. The value will override any value that is set on the container itself.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcontainers.com.

Parameters: height The height expressed as a Boundheight. E.g. "50:100px:200mm" or "100px".

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

hideMode

public final LC hideMode(int mode)
Same functionality as LC only this method returns this for chaining multiple calls.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Parameters: mode The mode:
0 == Normal. Bounds will be caclulated as if the component was visible.
1 == If hidden the size will be 0, 0 but the gaps remain.
2 == If hidden the size will be 0, 0 and gaps set to zero.
3 == If hidden the component will be disregarded completely and not take up a cell in the grid..

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

See Also: LC

insets

public final LC insets(String s)
Same functionality as setInsets(ConstraintParser.parseInsets(s, true)). This method returns this for chaining multiple calls.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Parameters: s The string to parse. E.g. "10 10 10 10" or "20". If less than 4 groups the last will be used for the missing.

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

See Also: (UnitValue[])

insets

public final LC insets(String top, String left, String bottom, String right)
Sets the different insets (expressed as a UnitValues, e.g. "10px" or "20mm") for the corresponding sides.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Parameters: top The top inset. E.g. "10px" or "10mm" or "related". May be null in which case the default inset for this side for the platform will be used. left The left inset. E.g. "10px" or "10mm" or "related". May be null in which case the default inset for this side for the platform will be used. bottom The bottom inset. E.g. "10px" or "10mm" or "related". May be null in which case the default inset for this side for the platform will be used. right The right inset. E.g. "10px" or "10mm" or "related". May be null in which case the default inset for this side for the platform will be used.

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

See Also: (UnitValue[])

insetsAll

public final LC insetsAll(String allSides)
Sets the same inset (expressed as a UnitValue, e.g. "10px" or "20mm") all around.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Parameters: allSides The unit value to set for all sides. May be null which means that the default panel insets for the platform is used.

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

See Also: (UnitValue[])

isFillX

public final boolean isFillX()
If the layout should always claim the whole bounds of the laid out container even if the preferred size is smaller.

Returns: true means fill. false is default.

isFillY

public final boolean isFillY()
If the layout should always claim the whole bounds of the laid out container even if the preferred size is smaller.

Returns: true means fill. false is default.

isFlowX

public final boolean isFlowX()
The default flow direction. Normally (which is true) this is horizontal and that means that the "next" component will be put in the cell to the right (or to the left if left-to-right is false).

Returns: true is the default flow horizontally.

See Also: setLeftToRight

isNoCache

public boolean isNoCache()
If components have sizes or positions linked to the bounds of the parent in some way (as for instance the "%" unit has) the cache must be turned off for the panel. If components does not get the correct or expected size or position try to set this property to true.

Returns: true means no cache and slightly slower layout.

isNoGrid

public final boolean isNoGrid()
If the whole layout should be non grid based. It is the same as setting the "nogrid" property on every row/column in the grid.

Returns: true means not grid based. false is default.

isTopToBottom

public final boolean isTopToBottom()
If the layout should go from the default top-to-bottom in the grid instead of the optinal bottom-to-top.

Returns: true for the default top-to-bottom.

isVisualPadding

public final boolean isVisualPadding()
If visual padding should be automatically used and compensated for by this layout instance.

Returns: true if visual padding.

leftToRight

public final LC leftToRight(boolean b)
Same functionality as setLeftToRight only this method returns this for chaining multiple calls.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Parameters: b true for forcing left-to-right. false for forcing right-to-left.

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

maxHeight

public final LC maxHeight(String height)
The maximum height for the container. The value will override any value that is set on the container itself.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcontainers.com.

Parameters: height The height expressed as a UnitValue. E.g. "100px" or "200mm".

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

maxWidth

public final LC maxWidth(String width)
The maximum width for the container. The value will override any value that is set on the container itself.

For a more thorough explanation of what this constraint does see the white paper or Cheat Sheet at www.migcontainers.com.

Parameters: width The width expressed as a UnitValue. E.g. "100px" or "200mm".

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

minHeight

public final LC minHeight(String height)
The minimum height for the container. The value will override any value that is set on the container itself.

For a more thorough explanation of what this constraint does see the white paper or Cheat Sheet at www.migcontainers.com.

Parameters: height The height expressed as a UnitValue. E.g. "100px" or "200mm".

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

minWidth

public final LC minWidth(String width)
The minimum width for the container. The value will override any value that is set on the container itself.

For a more thorough explanation of what this constraint does see the white paper or Cheat Sheet at www.migcontainers.com.

Parameters: width The width expressed as a UnitValue. E.g. "100px" or "200mm".

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

noCache

public final LC noCache()
Same functionality as LC only this method returns this for chaining multiple calls.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

noGrid

public final LC noGrid()
Same functionality as LC only this method returns this for chaining multiple calls.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

noVisualPadding

public final LC noVisualPadding()
Same functionality as LC only this method returns this for chaining multiple calls.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

pack

public final LC pack()
Short for, and thus same as, .pack("pref", "pref").

Same functionality as setPackHeight and setPackWidth only this method returns this for chaining multiple calls.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

Since: 3.5

pack

public final LC pack(String width, String height)
Sets the pack width and height.

Same functionality as setPackHeight and setPackWidth only this method returns this for chaining multiple calls.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Parameters: width The pack width. May be null. height The pack height. May be null.

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

Since: 3.5

packAlign

public final LC packAlign(float alignX, float alignY)
Sets the pack width and height alignment.

Same functionality as LC and LC only this method returns this for chaining multiple calls.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Parameters: alignX The pack width alignment. 0.5f is default. alignY The pack height alignment. 0.5f is default.

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

Since: 3.5

readExternal

public void readExternal(ObjectInput in)

rightToLeft

public final LC rightToLeft()
Same functionality as setLeftToRight(false) only this method returns this for chaining multiple calls.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

Since: 3.7.2

setAlignX

public final void setAlignX(UnitValue uv)
If the laid out components' bounds in total is less than the final size of the container these align values will be used to align the components in the parent. null is default and that means top/left alignment. The relative distances between the components will not be affected by this property.

Parameters: uv The new alignment. Use ConstraintParser to create the UnitValue. May be null.

setAlignY

public final void setAlignY(UnitValue uv)
If the laid out components' bounds in total is less than the final size of the container these align values will be used to align the components in the parent. null is default and that means top/left alignment. The relative distances between the components will not be affected by this property.

Parameters: uv The new alignment. Use ConstraintParser to create the UnitValue. May be null.

setDebugMillis

public final void setDebugMillis(int millis)
If > 0 the debug decorations will be repainted every millis. No debug information if <= 0 (default).

Parameters: millis The new debug repaint interval.

setFillX

public final void setFillX(boolean b)
If the layout should always claim the whole bounds of the laid out container even if the preferred size is smaller.

Parameters: b true means fill. false is default.

setFillY

public final void setFillY(boolean b)
If the layout should always claim the whole bounds of the laid out container even if the preferred size is smaller.

Parameters: b true means fill. false is default.

setFlowX

public final void setFlowX(boolean b)
The default flow direction. Normally (which is true) this is horizontal and that means that the "next" component will be put in the cell to the right (or to the left if left-to-right is false).

Parameters: b true is the default flow horizontally.

See Also: setLeftToRight

setGridGapX

public final void setGridGapX(BoundSize x)
If non-null (null is default) these value will be used as the default gaps between the columns in the grid.

Parameters: x The default grid gap between columns in the grid. If null the platform default is used.

setGridGapY

public final void setGridGapY(BoundSize y)
If non-null (null is default) these value will be used as the default gaps between the rows in the grid.

Parameters: y The default grid gap between rows in the grid. If null the platform default is used.

setHeight

public final void setHeight(BoundSize size)
Sets the minimum/preferred/maximum size for the container that this layout constraint is set for. Any of these sizes that is not null will be returned directly instead of determining the correspondig size through asking the components in this container.

Parameters: size The height for the container that this layout constraint is set for. null is translated to a bound size containing only null sizes.

Since: 3.5

setHideMode

public final void setHideMode(int mode)
How a component that is hidden (not visible) should be treated.

Parameters: mode The mode:
0 == Normal. Bounds will be caclulated as if the component was visible.
1 == If hidden the size will be 0, 0 but the gaps remain.
2 == If hidden the size will be 0, 0 and gaps set to zero.
3 == If hidden the component will be disregarded completely and not take up a cell in the grid..

setInsets

public final void setInsets(UnitValue[] ins)
The insets for the layed out panel. The insets will be an empty space around the components in the panel. null values means that the default panel insets for the platform is used. See PlatformDefaults.

Parameters: ins The new insets. Must be of length 4 (top, left, bottom, right) or null. The elements (1 to 4) may be null to use the platform default for that side. The array is copied for storage.

See Also: ConstraintParser

setLeftToRight

public final void setLeftToRight(Boolean b)
If the layout should be forced to be left-to-right or right-to-left. A value of null is default and means that this will be picked up from the java.util.Locale that the container being layed out is reporting.

Parameters: b Boolean.TRUE to force left-to-right. Boolean.FALSE to force tight-to-left. null for the default "let the current Locale decide".

setNoCache

public void setNoCache(boolean b)
If components have sizes or positions linked to the bounds of the parent in some way (as for instance the "%" unit has) the cache must be turned off for the panel. If components does not get the correct or expected size or position try to set this property to true.

Parameters: b true means no cache and slightly slower layout.

setNoGrid

public final void setNoGrid(boolean b)
If the whole layout should be non grid based. It is the same as setting the "nogrid" property on every row/column in the grid.

Parameters: b true means no grid. false is default.

setPackHeight

public final void setPackHeight(BoundSize size)
Sets the "pack height" for the window that this container is located in. When the size of this container changes the size of the window will be corrected to be within this BoundsSize. It can be used to set the minimum and/or maximum size of the window as well as the size window should optimally get. This optimal size is normaly its "preferred" size which is why "preferred" is the normal value to set here.

":push" can be appended to the bound size to only push the size bigger and never shrink it if the preferred size gets smaller.

E.g. "pref", "100:pref", "pref:700", "300::700", "pref:push"

Parameters: size The new pack size. If null it will be corrected to an "unset" BoundSize.

Since: 3.5

setPackHeightAlign

public final void setPackHeightAlign(float align)
If there is a resize of the window due to packing (see setPackHeight this value, which is between 0f and 1f, decides where the extra/surpurflous size is placed. 0f means that the window will resize so that the upper part moves up and the lower side stays in the same place. 0.5f will expand/reduce the window equally upwards and downwards. 1f will do the opposite of 0f of course.

Parameters: align The pack alignment. Always between 0f and 1f, inclusive. Values outside this will be truncated.

Since: 3.5

setPackWidth

public final void setPackWidth(BoundSize size)
Sets the "pack width" for the window that this container is located in. When the size of this container changes the size of the window will be corrected to be within this BoundsSize. It can be used to set the minimum and/or maximum size of the window as well as the size window should optimally get. This optimal size is normaly its "preferred" size which is why "preferred" is the normal value to set here.

":push" can be appended to the bound size to only push the size bigger and never shrink it if the preferred size gets smaller.

E.g. "pref", "100:pref", "pref:700", "300::700", "pref:push"

Parameters: size The new pack size. If null it will be corrected to an "unset" BoundSize.

Since: 3.5

setPackWidthAlign

public final void setPackWidthAlign(float align)
If there is a resize of the window due to packing (see setPackHeight this value, which is between 0f and 1f, decides where the extra/surpurflous size is placed. 0f means that the window will resize so that the left part moves left and the right side stays in the same place. 0.5f will expand/reduce the window equally to the right and lefts. 1f will do the opposite of 0f of course.

Parameters: align The pack alignment. Always between 0f and 1f, inclusive. Values outside this will be truncated.

Since: 3.5

setTopToBottom

public final void setTopToBottom(boolean b)
If the layout should go from the default top-to-bottom in the grid instead of the optinal bottom-to-top.

Parameters: b true for the default top-to-bottom.

setVisualPadding

public final void setVisualPadding(boolean b)
If visual padding should be automatically used and compensated for by this layout instance.

Parameters: b true turns on visual padding.

setWidth

public final void setWidth(BoundSize size)
Sets the minimum/preferred/maximum size for the container that this layout constraint is set for. Any of these sizes that is not null will be returned directly instead of determining the correspondig size through asking the components in this container.

Parameters: size The width for the container that this layout constraint is set for. null is translated to a bound size containing only null sizes.

Since: 3.5

setWrapAfter

public final void setWrapAfter(int count)
Sets after what cell the grid should always auto wrap.

Parameters: count After what cell the grid should always auto wrap. If 0 the number of columns/rows in the AC is used. LayoutUtil.INF is used for no auto wrap.

topToBottom

public final LC topToBottom()
Same functionality as LC only this method returns this for chaining multiple calls.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

Since: 3.7.2

width

public final LC width(String width)
The width for the container as a min and/or preferref and/or maximum width. The value will override any value that is set on the container itself.

For a more thorough explanation of what this constraint does see the white paper or Cheat Sheet at www.migcontainers.com.

Parameters: width The width expressed as a Boundwidth. E.g. "50:100px:200mm" or "100px".

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

wrap

public final LC wrap()
Sets a wrap after the number of columns/rows that is defined in the AC.

Same functionality as LC only this method returns this for chaining multiple calls.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

wrapAfter

public final LC wrapAfter(int count)
Same functionality as LC only this method returns this for chaining multiple calls.

For a more thorough explanation of what this constraint does see the white paper or cheat Sheet at www.migcomponents.com.

Parameters: count After what cell the grid should always auto wrap. If 0 the number of columns/rows in the

Returns: this so it is possible to chain calls. E.g. new LayoutConstraint().noGrid().gap().fill().

writeExternal

public void writeExternal(ObjectOutput out)