public class HorizontalGroup extends WidgetGroup
Table
when actors need to be inserted into or removed from the middle of the group. Group.getChildren()
can be
sorted to change the order of the actors (eg Actor.setZIndex(int)
). invalidate()
must be called after changing
the children order.
The preferred width is the sum of the children's preferred widths plus spacing. The preferred height is the largest preferred
height of any child. The preferred size is slightly different when wrap
is enabled. The min size is the
preferred size and the max size is 0.
Widgets are sized using their preferred width
, so widgets which return 0 as their preferred width
will be given a width of 0 (eg, a label with word wrap
enabled).
Constructor and Description |
---|
HorizontalGroup() |
Modifier and Type | Method and Description |
---|---|
HorizontalGroup |
align(int align)
Sets the alignment of all widgets within the horizontal group.
|
HorizontalGroup |
bottom()
Sets
Align.bottom and clears Align.top for the alignment of all widgets within the horizontal group. |
HorizontalGroup |
center()
Sets the alignment of all widgets within the horizontal group to
Align.center . |
protected void |
drawDebugBounds(ShapeRenderer shapes)
Draws a rectangle for the bounds of this actor if
Actor.getDebug() is true. |
HorizontalGroup |
expand() |
HorizontalGroup |
expand(boolean expand)
When true and wrap is false, the rows will take up the entire horizontal group height.
|
HorizontalGroup |
fill() |
HorizontalGroup |
fill(float fill) |
int |
getAlign() |
boolean |
getExpand() |
float |
getFill() |
float |
getPadBottom() |
float |
getPadLeft() |
float |
getPadRight() |
float |
getPadTop() |
float |
getPrefHeight() |
float |
getPrefWidth() |
boolean |
getReverse() |
int |
getRows()
When wrapping is enabled, the number of rows may be > 1.
|
float |
getSpace() |
boolean |
getWrap() |
boolean |
getWrapReverse() |
float |
getWrapSpace() |
HorizontalGroup |
grow()
Sets fill to 1 and expand to true.
|
void |
invalidate()
Invalidates this actor's layout, causing
Layout.layout() to happen the next time Layout.validate() is called. |
void |
layout()
Computes and caches any information needed for drawing and, if this actor has children, positions and sizes each child,
calls
Layout.invalidate() on any each child whose width or height has changed, and calls Layout.validate() on each
child. |
HorizontalGroup |
left()
Adds
Align.left and clears Align.right for the alignment of all widgets within the horizontal group. |
HorizontalGroup |
pad(float pad)
Sets the padTop, padLeft, padBottom, and padRight to the specified value.
|
HorizontalGroup |
pad(float top,
float left,
float bottom,
float right) |
HorizontalGroup |
padBottom(float padBottom) |
HorizontalGroup |
padLeft(float padLeft) |
HorizontalGroup |
padRight(float padRight) |
HorizontalGroup |
padTop(float padTop) |
HorizontalGroup |
reverse()
The children will be displayed last to first.
|
HorizontalGroup |
reverse(boolean reverse)
If true, the children will be displayed last to first.
|
HorizontalGroup |
right()
Adds
Align.right and clears Align.left for the alignment of all widgets within the horizontal group. |
HorizontalGroup |
rowAlign(int rowAlign)
Sets the horizontal alignment of each row of widgets when
wrapping is enabled and sets the vertical
alignment of widgets within each row. |
HorizontalGroup |
rowBottom()
Sets
Align.bottom and clears Align.top for the alignment of widgets within each row. |
HorizontalGroup |
rowCenter()
Sets the alignment of widgets within each row to
Align.center . |
HorizontalGroup |
rowLeft()
Adds
Align.left and clears Align.right for the alignment of each row of widgets when wrapping is enabled. |
HorizontalGroup |
rowRight()
Adds
Align.right and clears Align.left for the alignment of each row of widgets when wrapping is enabled. |
HorizontalGroup |
rowTop()
Sets
Align.top and clears Align.bottom for the alignment of widgets within each row. |
void |
setRound(boolean round)
If true (the default), positions and sizes are rounded to integers.
|
HorizontalGroup |
space(float space)
Sets the horizontal space between children.
|
HorizontalGroup |
top()
Sets
Align.top and clears Align.bottom for the alignment of all widgets within the horizontal group. |
HorizontalGroup |
wrap()
If false, the widgets are arranged in a single row and the preferred width is the widget widths plus spacing.
|
HorizontalGroup |
wrap(boolean wrap) |
HorizontalGroup |
wrapReverse()
Rows will wrap above the previous rows.
|
HorizontalGroup |
wrapReverse(boolean wrapReverse)
If true, rows will wrap above the previous rows.
|
HorizontalGroup |
wrapSpace(float wrapSpace)
Sets the vertical space between rows when wrap is enabled.
|
childrenChanged, draw, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, invalidateHierarchy, needsLayout, pack, setFillParent, setLayoutEnabled, sizeChanged, validate
act, addActor, addActorAfter, addActorAt, addActorBefore, applyTransform, applyTransform, clear, clear, clearChildren, clearChildren, computeTransform, debugAll, drawChildren, drawDebug, drawDebugChildren, findActor, getChild, getChildren, getCullingArea, hasChildren, hit, isTransform, localToDescendantCoordinates, removeActor, removeActor, removeActorAt, resetTransform, resetTransform, setCullingArea, setDebug, setStage, setTransform, swapActor, swapActor, toString
addAction, addCaptureListener, addListener, ancestorsVisible, ascendantsVisible, clearActions, clearListeners, clipBegin, clipBegin, clipEnd, debug, fire, firstAscendant, getActions, getCaptureListeners, getColor, getDebug, getHeight, getListeners, getName, getOriginX, getOriginY, getParent, getRight, getRotation, getScaleX, getScaleY, getStage, getTop, getTouchable, getUserObject, getWidth, getX, getX, getY, getY, getZIndex, hasActions, hasKeyboardFocus, hasParent, hasScrollFocus, isAscendantOf, isDescendantOf, isTouchable, isTouchFocusListener, isTouchFocusTarget, isVisible, localToActorCoordinates, localToAscendantCoordinates, localToParentCoordinates, localToScreenCoordinates, localToStageCoordinates, moveBy, notify, parentToLocalCoordinates, positionChanged, remove, removeAction, removeCaptureListener, removeListener, rotateBy, rotationChanged, scaleBy, scaleBy, scaleChanged, screenToLocalCoordinates, setBounds, setColor, setColor, setDebug, setHeight, setName, setOrigin, setOrigin, setOriginX, setOriginY, setParent, setPosition, setPosition, setRotation, setScale, setScale, setScaleX, setScaleY, setSize, setTouchable, setUserObject, setVisible, setWidth, setX, setX, setY, setY, setZIndex, sizeBy, sizeBy, stageToLocalCoordinates, toBack, toFront
public void invalidate()
Layout
Layout.layout()
to happen the next time Layout.validate()
is called. This
method should be called when state changes in the actor that requires a layout but does not change the minimum, preferred,
maximum, or actual size of the actor (meaning it does not affect the parent actor's layout).invalidate
in interface Layout
invalidate
in class WidgetGroup
public void layout()
Layout
Layout.invalidate()
on any each child whose width or height has changed, and calls Layout.validate()
on each
child. This method should almost never be called directly, instead Layout.validate()
should be used.layout
in interface Layout
layout
in class WidgetGroup
public float getPrefWidth()
getPrefWidth
in interface Layout
getPrefWidth
in class WidgetGroup
public float getPrefHeight()
getPrefHeight
in interface Layout
getPrefHeight
in class WidgetGroup
public int getRows()
public void setRound(boolean round)
public HorizontalGroup reverse()
public HorizontalGroup reverse(boolean reverse)
public boolean getReverse()
public HorizontalGroup wrapReverse()
public HorizontalGroup wrapReverse(boolean wrapReverse)
public boolean getWrapReverse()
public HorizontalGroup space(float space)
public float getSpace()
public HorizontalGroup wrapSpace(float wrapSpace)
public float getWrapSpace()
public HorizontalGroup pad(float pad)
public HorizontalGroup pad(float top, float left, float bottom, float right)
public HorizontalGroup padTop(float padTop)
public HorizontalGroup padLeft(float padLeft)
public HorizontalGroup padBottom(float padBottom)
public HorizontalGroup padRight(float padRight)
public float getPadTop()
public float getPadLeft()
public float getPadBottom()
public float getPadRight()
public HorizontalGroup align(int align)
Align.center
, Align.top
,
Align.bottom
, Align.left
, Align.right
, or any combination of those.public HorizontalGroup center()
Align.center
. This clears any other alignment.public HorizontalGroup top()
Align.top
and clears Align.bottom
for the alignment of all widgets within the horizontal group.public HorizontalGroup left()
Align.left
and clears Align.right
for the alignment of all widgets within the horizontal group.public HorizontalGroup bottom()
Align.bottom
and clears Align.top
for the alignment of all widgets within the horizontal group.public HorizontalGroup right()
Align.right
and clears Align.left
for the alignment of all widgets within the horizontal group.public int getAlign()
public HorizontalGroup fill()
public HorizontalGroup fill(float fill)
fill
- 0 will use preferred width.public float getFill()
public HorizontalGroup expand()
public HorizontalGroup expand(boolean expand)
public boolean getExpand()
public HorizontalGroup grow()
public HorizontalGroup wrap()
If true, the widgets will wrap using the width of the horizontal group. The preferred width of the group will be 0 as it is expected that something external will set the width of the group. Widgets are sized to their preferred width unless it is larger than the group's width, in which case they are sized to the group's width but not less than their minimum width. Default is false.
When wrap is enabled, the group's preferred height depends on the width of the group. In some cases the parent of the group will need to layout twice: once to set the width of the group and a second time to adjust to the group's new preferred height.
public HorizontalGroup wrap(boolean wrap)
public boolean getWrap()
public HorizontalGroup rowAlign(int rowAlign)
wrapping
is enabled and sets the vertical
alignment of widgets within each row. Set to Align.center
, Align.top
, Align.bottom
,
Align.left
, Align.right
, or any combination of those.public HorizontalGroup rowCenter()
Align.center
. This clears any other alignment.public HorizontalGroup rowTop()
Align.top
and clears Align.bottom
for the alignment of widgets within each row.public HorizontalGroup rowLeft()
Align.left
and clears Align.right
for the alignment of each row of widgets when wrapping
is enabled.public HorizontalGroup rowBottom()
Align.bottom
and clears Align.top
for the alignment of widgets within each row.public HorizontalGroup rowRight()
Align.right
and clears Align.left
for the alignment of each row of widgets when wrapping
is enabled.protected void drawDebugBounds(ShapeRenderer shapes)
Actor
Actor.getDebug()
is true.drawDebugBounds
in class Actor