HBox

java.lang.Object
- Parent
- - javafx.scene.layout.Region
  - - javafx.scene.layout.Pane
    - - javafx.scene.layout.HBox

public class HBox
extends Pane

HBox lays out its children in a single horizontal row. If the hbox has a border and/or padding set, then the contents will be laid out within those insets.

HBox example:


     HBox hbox = new HBox(8); // spacing = 8
     hbox.getChildren().addAll(new Label("Name:), new TextBox());

HBox will resize children (if resizable) to their preferred widths and uses its fillHeight property to determine whether to resize their heights to fill its own height or keep their heights to their preferred (fillHeight defaults to true). The alignment of the content is controlled by the alignment property, which defaults to Pos.TOP_LEFT.

If an hbox is resized larger than its preferred width, by default it will keep children to their preferred widths, leaving the extra space unused. If an application wishes to have one or more children be allocated that extra space it may optionally set an hgrow constraint on the child. See "Optional Layout Constraints" for details.

HBox lays out each managed child regardless of the child's visible property value; unmanaged children are ignored.

Resizable Range

An hbox's parent will resize the hbox within the hbox's resizable range during layout. By default the hbox computes this range based on its content as outlined in the table below.

HBox Resize Table
	width	height
minimum	left/right insets plus the sum of each child's min width plus spacing between each child.	top/bottom insets plus the largest of the children's min heights.
preferred	left/right insets plus the sum of each child's pref width plus spacing between each child.	top/bottom insets plus the largest of the children's pref heights.
maximum	Double.MAX_VALUE	Double.MAX_VALUE

An hbox's unbounded maximum width and height are an indication to the parent that it may be resized beyond its preferred size to fill whatever space is assigned to it.

HBox provides properties for setting the size range directly. These properties default to the sentinel value USE_COMPUTED_SIZE, however the application may set them to other values as needed:


     hbox.setPrefWidth(400);

Applications may restore the computed values by setting these properties back to USE_COMPUTED_SIZE.

HBox does not clip its content by default, so it is possible that children's bounds may extend outside its own bounds if a child's min size prevents it from being fit within the hbox.

Optional Layout Constraints

An application may set constraints on individual children to customize HBox's layout. For each constraint, HBox provides a static method for setting it on the child.

HBox Constraint Table
Constraint	Type	Description
hgrow	javafx.scene.layout.Priority	The horizontal grow priority for the child.
margin	javafx.geometry.Insets	Margin space around the outside of the child.

For example, if an hbox needs the TextField to be allocated all extra space:


     HBox hbox = new HBox();
     TextField field = new TextField();
     HBox.setHgrow(field, Priority.ALWAYS);
     hbox.getChildren().addAll(new Label("Search:"), field, new Button("Go"));

If more than one child has the same grow priority set, then the hbox will allocate equal amounts of space to each. HBox will only grow a child up to its maximum width, so if the child has a max width other than Double.MAX_VALUE, the application may need to override the max to allow it to grow. For example:


     HBox hbox = new HBox();
     Button button1 = new Button("Add");
     Button button2 = new Button("Remove");
     HBox.setHgrow(button1, Priority.ALWAYS);
     HBox.setHgrow(button2, Priority.ALWAYS);
     button1.setMaxWidth(Double.MAX_VALUE);
     button2.setMaxWidth(Double.MAX_VALUE);
     hbox.getChildren().addAll(button1, button2);

Since:: JavaFX 2.0

Property Summary

All Methods Instance Methods Concrete Methods
Type	Property and Description
`<any>`	`alignment` The overall alignment of children within the hbox's width and height.
`BooleanProperty`	`fillHeight` Whether or not resizable children will be resized to fill the full height of the hbox or be resized to their preferred height and aligned according to the `alignment` vpos value.
`DoubleProperty`	`spacing` The amount of horizontal space between each child in the hbox.

Properties inherited from class javafx.scene.layout.Region
backgroundProperty, borderProperty, cacheShapeProperty, centerShapeProperty, heightProperty, insetsProperty, maxHeightProperty, maxWidthProperty, minHeightProperty, minWidthProperty, opaqueInsetsProperty, paddingProperty, prefHeightProperty, prefWidthProperty, scaleShapeProperty, shapeProperty, snapToPixelProperty, widthProperty

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`private static class`	`HBox.StyleableProperties` * Stylesheet Handling * *

Field Summary

Fields
Modifier and Type	Field and Description
`private <any>`	`alignment`
`private double`	`baselineOffset`
`private Orientation`	`bias`
`private boolean`	`biasDirty`
`private BooleanProperty`	`fillHeight`
`private static java.lang.String`	`HGROW_CONSTRAINT`
`private static java.lang.String`	`MARGIN_CONSTRAINT` BEGIN static methods
`private static <any>`	`marginAccessor`
`private double`	`minBaselineComplement`
`private double`	`prefBaselineComplement`
`private DoubleProperty`	`spacing`
`private double[][]`	`tempArray`

Fields inherited from class javafx.scene.layout.Region
TEMP_VEC2D, USE_COMPUTED_SIZE, USE_PREF_SIZE

Constructor Summary

Constructors
Constructor and Description
`HBox()` Creates an HBox layout with spacing = 0.
`HBox(double spacing)` Creates an HBox layout with the specified spacing between children.
`HBox(double spacing, Node... children)` Creates an HBox layout with the specified spacing between children.
`HBox(Node... children)` Creates an HBox layout with spacing = 0.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`private double`	`adjustAreaWidths(java.util.List<Node> managed, double[][] areaWidths, double width, double height)`
`<any>`	`alignmentProperty()` The overall alignment of children within the hbox's width and height.
`static void`	`clearConstraints(Node child)` Removes all hbox constraints from the child node.
`private double`	`computeContentWidth(java.util.List<Node> managedChildren, double height, boolean minimum)`
`protected double`	`computeMinHeight(double width)` Computes the minimum height of this region.
`protected double`	`computeMinWidth(double height)` Computes the minimum width of this region.
`protected double`	`computePrefHeight(double width)` Computes the preferred height of this region for the given width; Region subclasses should override this method to return an appropriate value based on their content and layout strategy.
`protected double`	`computePrefWidth(double height)` Computes the preferred width of this region for the given height.
`BooleanProperty`	`fillHeightProperty()` Whether or not resizable children will be resized to fill the full height of the hbox or be resized to their preferred height and aligned according to the `alignment` vpos value.
`Pos`	`getAlignment()` Gets the value of the property alignment.
`private Pos`	`getAlignmentInternal()`
`private double[][]`	`getAreaWidths(java.util.List<Node> managed, double height, boolean minimum)`
`double`	`getBaselineOffset()`
`static java.util.List<<any>>`	`getClassCssMetaData()`
`Orientation`	`getContentBias()`
`java.util.List<<any>>`	`getCssMetaData()`
`static Priority`	`getHgrow(Node child)` Returns the child's hgrow constraint if set.
`static Insets`	`getMargin(Node child)` Returns the child's margin constraint if set.
`private double`	`getMinBaselineComplement()`
`private double`	`getPrefBaselineComplement()`
`double`	`getSpacing()` Gets the value of the property spacing.
`private double[][]`	`getTempArray(int size)`
`private double`	`growOrShrinkAreaWidths(java.util.List<Node> managed, double[][] areaWidths, Priority priority, double extraWidth, double height)`
`boolean`	`isFillHeight()` Gets the value of the property fillHeight.
`protected void`	`layoutChildren()`
`void`	`requestLayout()`
`void`	`setAlignment(Pos value)` Sets the value of the property alignment.
`void`	`setFillHeight(boolean value)` Sets the value of the property fillHeight.
`static void`	`setHgrow(Node child, Priority value)` Sets the horizontal grow priority for the child when contained by an hbox.
`static void`	`setMargin(Node child, Insets value)` Sets the margin for the child when contained by an hbox.
`void`	`setSpacing(double value)` Sets the value of the property spacing.
`private boolean`	`shouldFillHeight()`
`DoubleProperty`	`spacingProperty()` The amount of horizontal space between each child in the hbox.
`private static double`	`sum(double[] array, int size)`

Methods inherited from class javafx.scene.layout.Pane
getChildren, getConstraint, setConstraint

Methods inherited from class javafx.scene.layout.Region
addImageListener, adjustHeightByMargin, adjustWidthByMargin, backgroundProperty, borderProperty, boundedNodeSizeWithBias, boundedSize, cacheShapeProperty, centerShapeProperty, computeChildMaxAreaHeight, computeChildMaxAreaWidth, computeChildMinAreaHeight, computeChildMinAreaHeight, computeChildMinAreaWidth, computeChildMinAreaWidth, computeChildPrefAreaHeight, computeChildPrefAreaHeight, computeChildPrefAreaWidth, computeChildPrefAreaWidth, computeMaxHeight, computeMaxMinAreaHeight, computeMaxMinAreaHeight, computeMaxMinAreaHeight, computeMaxMinAreaWidth, computeMaxMinAreaWidth, computeMaxMinAreaWidth, computeMaxPrefAreaHeight, computeMaxPrefAreaHeight, computeMaxPrefAreaHeight, computeMaxPrefAreaWidth, computeMaxPrefAreaWidth, computeMaxPrefAreaWidth, computeMaxWidth, computeXOffset, computeYOffset, createDoubleArray, getAreaBaselineOffset, getAreaBaselineOffset, getAreaBaselineOffset, getAreaBaselineOffset, getAreaBaselineOffset, getAreaBaselineOffset, getBackground, getBorder, getHeight, getInsets, getMaxBaselineComplement, getMaxHeight, getMaxWidth, getMinBaselineComplement, getMinHeight, getMinWidth, getOpaqueInsets, getPadding, getPrefBaselineComplement, getPrefHeight, getPrefWidth, getShape, getUserAgentStylesheet, getWidth, heightProperty, insetsProperty, isCacheShape, isCenterShape, isResizable, isScaleShape, isSnapToPixel, layoutInArea, layoutInArea, layoutInArea, layoutInArea, maxHeight, maxHeightProperty, maxWidth, maxWidthProperty, minHeight, minHeightProperty, minWidth, minWidthProperty, opaqueInsetsProperty, paddingProperty, positionInArea, positionInArea, prefHeight, prefHeightProperty, prefWidth, prefWidthProperty, removeImageListener, resize, scaleShapeProperty, setBackground, setBorder, setCacheShape, setCenterShape, setHeight, setMaxHeight, setMaxSize, setMaxWidth, setMinHeight, setMinSize, setMinWidth, setOpaqueInsets, setPadding, setPrefHeight, setPrefSize, setPrefWidth, setScaleShape, setShape, setSnapToPixel, setWidth, shapeProperty, snappedBottomInset, snappedLeftInset, snappedRightInset, snappedTopInset, snapPortionX, snapPortionY, snapPosition, snapPositionX, snapPositionY, snapSize, snapSizeX, snapSizeY, snapSpace, snapSpaceX, snapSpaceY, snapToPixelProperty, widthProperty

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Property Detail
  - spacing
```
public final DoubleProperty spacingProperty
```
    The amount of horizontal space between each child in the hbox.
    
    See Also:
    
    getSpacing(), setSpacing(double)
  - alignment
```
public final <any> alignmentProperty
```
    The overall alignment of children within the hbox's width and height.
    
    See Also:
    
    getAlignment(), setAlignment(Pos)
  - fillHeight
```
public final BooleanProperty fillHeightProperty
```
    Whether or not resizable children will be resized to fill the full height of the hbox or be resized to their preferred height and aligned according to the alignment vpos value. Note that if the hbox vertical alignment is set to BASELINE, then this property will be ignored and children will be resized to their preferred heights.
    
    See Also:
    
    isFillHeight(), setFillHeight(boolean)
- Field Detail
  - biasDirty
```
private boolean biasDirty
```
  - minBaselineComplement
```
private double minBaselineComplement
```
  - prefBaselineComplement
```
private double prefBaselineComplement
```
  - bias
```
private Orientation bias
```
  - tempArray
```
private double[][] tempArray
```
  - MARGIN_CONSTRAINT
```
private static final java.lang.String MARGIN_CONSTRAINT
```
    BEGIN static methods
    
    See Also:
    
    Constant Field Values
  - HGROW_CONSTRAINT
```
private static final java.lang.String HGROW_CONSTRAINT
```
    See Also:
    
    Constant Field Values
  - marginAccessor
```
private static final <any> marginAccessor
```
  - spacing
```
private DoubleProperty spacing
```
  - alignment
```
private <any> alignment
```
  - fillHeight
```
private BooleanProperty fillHeight
```
  - baselineOffset
```
private double baselineOffset
```
- Constructor Detail
  - HBox
```
public HBox()
```
    Creates an HBox layout with spacing = 0.
  - HBox
```
public HBox(double spacing)
```
    Creates an HBox layout with the specified spacing between children.
    
    Parameters:
    
    spacing - the amount of horizontal space between each child
  - HBox
```
public HBox(Node... children)
```
    Creates an HBox layout with spacing = 0.
    
    Parameters:
    
    children - The initial set of children for this pane.
    
    Since:
    
    JavaFX 8.0
  - HBox
```
public HBox(double spacing,
            Node... children)
```
    Creates an HBox layout with the specified spacing between children.
    
    Parameters:
    
    spacing - the amount of horizontal space between each child
    
    children - The initial set of children for this pane.
    
    Since:
    
    JavaFX 8.0
- Method Detail
  - setHgrow
```
public static void setHgrow(Node child,
                            Priority value)
```
    Sets the horizontal grow priority for the child when contained by an hbox. If set, the hbox will use the priority to allocate additional space if the hbox is resized larger than it's preferred width. If multiple hbox children have the same horizontal grow priority, then the extra space will be split evenly between them. If no horizontal grow priority is set on a child, the hbox will never allocate it additional horizontal space if available. Setting the value to null will remove the constraint.
    
    Parameters:
    
    child - the child of an hbox
    
    value - the horizontal grow priority for the child
  - getHgrow
```
public static Priority getHgrow(Node child)
```
    Returns the child's hgrow constraint if set.
    
    Parameters:
    
    child - the child node of an hbox
    
    Returns:
    
    the horizontal grow priority for the child or null if no priority was set
  - setMargin
```
public static void setMargin(Node child,
                             Insets value)
```
    Sets the margin for the child when contained by an hbox. If set, the hbox will layout the child with the margin space around it. Setting the value to null will remove the constraint.
    
    Parameters:
    
    child - the child mode of the hbox
    
    value - the margin of space around the child
  - getMargin
```
public static Insets getMargin(Node child)
```
    Returns the child's margin constraint if set.
    
    Parameters:
    
    child - the child node of an hbox
    
    Returns:
    
    the margin for the child or null if no margin was set
  - clearConstraints
```
public static void clearConstraints(Node child)
```
    Removes all hbox constraints from the child node.
    
    Parameters:
    
    child - the child node
  - spacingProperty
```
public final DoubleProperty spacingProperty()
```
    The amount of horizontal space between each child in the hbox.
    
    See Also:
    
    getSpacing(), setSpacing(double)
  - setSpacing
```
public final void setSpacing(double value)
```
    Sets the value of the property spacing.
  - getSpacing
```
public final double getSpacing()
```
    Gets the value of the property spacing.
  - alignmentProperty
```
public final <any> alignmentProperty()
```
    The overall alignment of children within the hbox's width and height.
    
    See Also:
    
    getAlignment(), setAlignment(Pos)
  - setAlignment
```
public final void setAlignment(Pos value)
```
    Sets the value of the property alignment.
  - getAlignment
```
public final Pos getAlignment()
```
    Gets the value of the property alignment.
  - getAlignmentInternal
```
private Pos getAlignmentInternal()
```
  - fillHeightProperty
```
public final BooleanProperty fillHeightProperty()
```
    Whether or not resizable children will be resized to fill the full height of the hbox or be resized to their preferred height and aligned according to the alignment vpos value. Note that if the hbox vertical alignment is set to BASELINE, then this property will be ignored and children will be resized to their preferred heights.
    
    See Also:
    
    isFillHeight(), setFillHeight(boolean)
  - setFillHeight
```
public final void setFillHeight(boolean value)
```
    Sets the value of the property fillHeight.
  - isFillHeight
```
public final boolean isFillHeight()
```
    Gets the value of the property fillHeight.
  - shouldFillHeight
```
private boolean shouldFillHeight()
```
  - getContentBias
```
public Orientation getContentBias()
```
    Returns:
    
    null unless one of its children has a content bias.
  - computeMinWidth
```
protected double computeMinWidth(double height)
```
    Description copied from class: Region
    
    Computes the minimum width of this region. Returns the sum of the left and right insets by default. region subclasses should override this method to return an appropriate value based on their content and layout strategy. If the subclass doesn't have a VERTICAL content bias, then the height parameter can be ignored.
    
    Overrides:
    
    computeMinWidth in class Region
    
    Returns:
    
    the computed minimum width of this region
  - computeMinHeight
```
protected double computeMinHeight(double width)
```
    Description copied from class: Region
    
    Computes the minimum height of this region. Returns the sum of the top and bottom insets by default. Region subclasses should override this method to return an appropriate value based on their content and layout strategy. If the subclass doesn't have a HORIZONTAL content bias, then the width parameter can be ignored.
    
    Overrides:
    
    computeMinHeight in class Region
    
    Returns:
    
    the computed minimum height for this region
  - computePrefWidth
```
protected double computePrefWidth(double height)
```
    Description copied from class: Region
    
    Computes the preferred width of this region for the given height. Region subclasses should override this method to return an appropriate value based on their content and layout strategy. If the subclass doesn't have a VERTICAL content bias, then the height parameter can be ignored.
    
    Overrides:
    
    computePrefWidth in class Region
    
    Returns:
    
    the computed preferred width for this region
  - computePrefHeight
```
protected double computePrefHeight(double width)
```
    Description copied from class: Region
    
    Computes the preferred height of this region for the given width; Region subclasses should override this method to return an appropriate value based on their content and layout strategy. If the subclass doesn't have a HORIZONTAL content bias, then the width parameter can be ignored.
    
    Overrides:
    
    computePrefHeight in class Region
    
    Returns:
    
    the computed preferred height for this region
  - getAreaWidths
```
private double[][] getAreaWidths(java.util.List<Node> managed,
                                 double height,
                                 boolean minimum)
```
  - adjustAreaWidths
```
private double adjustAreaWidths(java.util.List<Node> managed,
                                double[][] areaWidths,
                                double width,
                                double height)
```
  - growOrShrinkAreaWidths
```
private double growOrShrinkAreaWidths(java.util.List<Node> managed,
                                      double[][] areaWidths,
                                      Priority priority,
                                      double extraWidth,
                                      double height)
```
  - computeContentWidth
```
private double computeContentWidth(java.util.List<Node> managedChildren,
                                   double height,
                                   boolean minimum)
```
  - sum
```
private static double sum(double[] array,
                          int size)
```
  - requestLayout
```
public void requestLayout()
```
  - getMinBaselineComplement
```
private double getMinBaselineComplement()
```
  - getPrefBaselineComplement
```
private double getPrefBaselineComplement()
```
  - getBaselineOffset
```
public double getBaselineOffset()
```
  - layoutChildren
```
protected void layoutChildren()
```
  - getTempArray
```
private double[][] getTempArray(int size)
```
  - getClassCssMetaData
```
public static java.util.List<<any>> getClassCssMetaData()
```
    Returns:
    
    The CssMetaData associated with this class, which may include the CssMetaData of its superclasses.
    
    Since:
    
    JavaFX 8.0
  - getCssMetaData
```
public java.util.List<<any>> getCssMetaData()
```
    Overrides:
    
    getCssMetaData in class Region
    
    Since:
    
    JavaFX 8.0

Class HBox

Resizable Range

Optional Layout Constraints

Property Summary

Properties inherited from class javafx.scene.layout.Region

Nested Class Summary

Field Summary

Fields inherited from class javafx.scene.layout.Region

Constructor Summary

Method Summary

Methods inherited from class javafx.scene.layout.Pane

Methods inherited from class javafx.scene.layout.Region

Methods inherited from class java.lang.Object

Property Detail

spacing

alignment

fillHeight

Field Detail

biasDirty

minBaselineComplement

prefBaselineComplement

bias

tempArray

MARGIN_CONSTRAINT

HGROW_CONSTRAINT

marginAccessor

spacing

alignment

fillHeight

baselineOffset

Constructor Detail

HBox

HBox

HBox

HBox

Method Detail

setHgrow

getHgrow

setMargin

getMargin

clearConstraints

spacingProperty

setSpacing

getSpacing

alignmentProperty

setAlignment

getAlignment

getAlignmentInternal

fillHeightProperty

setFillHeight

isFillHeight

shouldFillHeight

getContentBias

computeMinWidth

computeMinHeight

computePrefWidth

computePrefHeight

getAreaWidths

adjustAreaWidths

growOrShrinkAreaWidths

computeContentWidth

sum

requestLayout

getMinBaselineComplement

getPrefBaselineComplement

getBaselineOffset

layoutChildren

getTempArray

getClassCssMetaData

getCssMetaData