TabPane

java.lang.Object
- Region
- - javafx.scene.control.Control
  - - javafx.scene.control.TabPane

All Implemented Interfaces:

Skinnable
```
public class TabPane
extends Control
```
A control that allows switching between a group of Tabs. Only one tab is visible at a time. Tabs are added to the TabPane by using the getTabs().

Tabs in a TabPane can be positioned at any of the four sides by specifying the Side.

A TabPane has two modes floating or recessed. Applying the styleclass STYLE_CLASS_FLOATING will change the TabPane mode to floating.

The tabs width and height can be set to a specific size by setting the min and max for height and width. TabPane default width will be determined by the largest content width in the TabPane. This is the same for the height. If a different size is desired the width and height of the TabPane can be overridden by setting the min, pref and max size.

When the number of tabs do not fit the TabPane a menu button will appear on the right. The menu button is used to select the tabs that are currently not visible.

Example:
```
 TabPane tabPane = new TabPane();
 Tab tab = new Tab();
 tab.setText("new tab");
 tab.setContent(new Rectangle(200,200, Color.LIGHTSTEELBLUE));
 tabPane.getTabs().add(tab);
 
```
Since:

JavaFX 2.0

See Also:

Tab

Property Summary

All Methods Instance Methods Concrete Methods
Type	Property and Description
`BooleanProperty`	`rotateGraphic` The rotateGraphic state of the tabs in the TabPane.
`<any>`	`selectionModel` The selection model used for selecting tabs.
`<any>`	`side` The position of the tabs in the TabPane.
`<any>`	`tabClosingPolicy` The closing policy for the tabs.
`<any>`	`tabDragPolicy` The drag policy for the tabs.
`DoubleProperty`	`tabMaxHeight` The maximum height of the tabs in the TabPane.
`DoubleProperty`	`tabMaxWidth` The maximum width of the tabs in the TabPane.
`DoubleProperty`	`tabMinHeight` The minimum height of the tab.
`DoubleProperty`	`tabMinWidth` The minimum width of the tabs in the TabPane.

Properties inherited from class javafx.scene.control.Control
contextMenuProperty, skinClassNameProperty, skinProperty, tooltipProperty

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`private static class`	`TabPane.StyleableProperties` * Stylesheet Handling * *
`static class`	`TabPane.TabClosingPolicy` This specifies how the TabPane handles tab closing from an end-users perspective.
`static class`	`TabPane.TabDragPolicy` This enum specifies drag policies for tabs in a TabPane.
`(package private) static class`	`TabPane.TabPaneSelectionModel` * Support classes * *

Field Summary

Fields
Modifier and Type	Field and Description
`private static PseudoClass`	`BOTTOM_PSEUDOCLASS_STATE`
`private static double`	`DEFAULT_TAB_MAX_HEIGHT`
`private static double`	`DEFAULT_TAB_MAX_WIDTH`
`private static double`	`DEFAULT_TAB_MIN_HEIGHT`
`private static double`	`DEFAULT_TAB_MIN_WIDTH`
`private static PseudoClass`	`LEFT_PSEUDOCLASS_STATE`
`private static PseudoClass`	`RIGHT_PSEUDOCLASS_STATE`
`private BooleanProperty`	`rotateGraphic`
`private <any>`	`selectionModel`
`private <any>`	`side`
`static java.lang.String`	`STYLE_CLASS_FLOATING` TabPane mode will be changed to floating allowing the TabPane to be placed alongside other control.
`private <any>`	`tabClosingPolicy`
`private <any>`	`tabDragPolicy`
`private DoubleProperty`	`tabMaxHeight` The maximum height if the tabs in the TabPane.
`private DoubleProperty`	`tabMaxWidth` Specifies the maximum width of a tab.
`private DoubleProperty`	`tabMinHeight`
`private DoubleProperty`	`tabMinWidth`
`private <any>`	`tabs`
`private static PseudoClass`	`TOP_PSEUDOCLASS_STATE`

Constructor Summary

Constructors
Constructor and Description

TabPane()
Constructs a new TabPane.

TabPane(Tab... tabs)
Constructs a new TabPane with the given tabs set to show.

Constructors
Constructor and Description
`TabPane()` Constructs a new TabPane.
`TabPane(Tab... tabs)` Constructs a new TabPane with the given tabs set to show.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected Skin<?>`	`createDefaultSkin()` Create a new instance of the default skin for this control.
`static java.util.List<<any>>`	`getClassCssMetaData()`
`java.util.List<<any>>`	`getControlCssMetaData()`
`SingleSelectionModel<Tab>`	`getSelectionModel()` Gets the model used for tab selection.
`Side`	`getSide()` The current position of the tabs in the TabPane.
`TabPane.TabClosingPolicy`	`getTabClosingPolicy()` The closing policy for the tabs.
`TabPane.TabDragPolicy`	`getTabDragPolicy()` Gets the value of the property tabDragPolicy.
`double`	`getTabMaxHeight()` The maximum height of the tabs in the TabPane.
`double`	`getTabMaxWidth()` The maximum width of the tabs in the TabPane.
`double`	`getTabMinHeight()` The minimum height of the tabs in the TabPane.
`double`	`getTabMinWidth()` The minimum width of the tabs in the TabPane.
`<any>`	`getTabs()` The tabs to display in this TabPane.
`boolean`	`isRotateGraphic()` Returns `true` if the graphic inside a Tab is rotated.
`Node`	`lookup(java.lang.String selector)`
`java.util.Set<Node>`	`lookupAll(java.lang.String selector)`
`BooleanProperty`	`rotateGraphicProperty()` The rotateGraphic state of the tabs in the TabPane.
`<any>`	`selectionModelProperty()` The selection model used for selecting tabs.
`void`	`setRotateGraphic(boolean value)` Specifies whether the graphic inside a Tab is rotated or not, such that it is always upright, or rotated in the same way as the Tab text is.
`void`	`setSelectionModel(SingleSelectionModel<Tab> value)` Sets the model used for tab selection.
`void`	`setSide(Side value)` The position to place the tabs in this TabPane.
`void`	`setTabClosingPolicy(TabPane.TabClosingPolicy value)` Specifies how the TabPane handles tab closing from an end-users perspective.
`void`	`setTabDragPolicy(TabPane.TabDragPolicy value)` Sets the value of the property tabDragPolicy.
`void`	`setTabMaxHeight(double value)` Sets the value of the property tabMaxHeight.
`void`	`setTabMaxWidth(double value)` Sets the value of the property tabMaxWidth.
`void`	`setTabMinHeight(double value)` The minimum height of the tabs in the TabPane.
`void`	`setTabMinWidth(double value)` The minimum width of the tabs in the TabPane.
`<any>`	`sideProperty()` The position of the tabs in the TabPane.
`<any>`	`tabClosingPolicyProperty()` The closing policy for the tabs.
`<any>`	`tabDragPolicyProperty()` The drag policy for the tabs.
`DoubleProperty`	`tabMaxHeightProperty()` The maximum height of the tabs in the TabPane.
`DoubleProperty`	`tabMaxWidthProperty()` The maximum width of the tabs in the TabPane.
`DoubleProperty`	`tabMinHeightProperty()` The minimum height of the tab.
`DoubleProperty`	`tabMinWidthProperty()` The minimum width of the tabs in the TabPane.

Methods inherited from class javafx.scene.control.Control
computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, computePrefHeight, computePrefWidth, contextMenuProperty, executeAccessibleAction, getBaselineOffset, getContextMenu, getControlChildren, getCssMetaData, getInitialFocusTraversable, getSkin, getTooltip, isResizable, layoutChildren, loadSkinClass, queryAccessibleAttribute, setContextMenu, setSkin, setTooltip, skinClassNameProperty, skinProperty, tooltipProperty

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

- Property Detail
  - selectionModel
```
public final <any> selectionModelProperty
```
    The selection model used for selecting tabs.
    
    See Also:
    
    getSelectionModel(), setSelectionModel(SingleSelectionModel)
  - side
```
public final <any> sideProperty
```
    The position of the tabs in the TabPane.
    
    See Also:
    
    getSide(), setSide(Side)
  - tabClosingPolicy
```
public final <any> tabClosingPolicyProperty
```
    The closing policy for the tabs.
    
    See Also:
    
    getTabClosingPolicy(), setTabClosingPolicy(TabClosingPolicy)
  - rotateGraphic
```
public final BooleanProperty rotateGraphicProperty
```
    The rotateGraphic state of the tabs in the TabPane.
    
    See Also:
    
    isRotateGraphic(), setRotateGraphic(boolean)
  - tabMinWidth
```
public final DoubleProperty tabMinWidthProperty
```
    The minimum width of the tabs in the TabPane.
    
    See Also:
    
    getTabMinWidth(), setTabMinWidth(double)
  - tabMaxWidth
```
public final DoubleProperty tabMaxWidthProperty
```
    The maximum width of the tabs in the TabPane.
    
    Returns:
    
    the maximum width property
  - tabMinHeight
```
public final DoubleProperty tabMinHeightProperty
```
    The minimum height of the tab.
    
    See Also:
    
    getTabMinHeight(), setTabMinHeight(double)
  - tabMaxHeight
```
public final DoubleProperty tabMaxHeightProperty
```
    The maximum height of the tabs in the TabPane.
    
    Returns:
    
    the maximum height of the tabs
  - tabDragPolicy
```
public final <any> tabDragPolicyProperty
```
    The drag policy for the tabs. The policy can be changed dynamically.
    
    Since:
    
    10
    
    See Also:
    
    getTabDragPolicy(), setTabDragPolicy(TabDragPolicy)
- Field Detail
  - DEFAULT_TAB_MIN_WIDTH
```
private static final double DEFAULT_TAB_MIN_WIDTH
```
    See Also:
    
    Constant Field Values
  - DEFAULT_TAB_MAX_WIDTH
```
private static final double DEFAULT_TAB_MAX_WIDTH
```
    See Also:
    
    Constant Field Values
  - DEFAULT_TAB_MIN_HEIGHT
```
private static final double DEFAULT_TAB_MIN_HEIGHT
```
    See Also:
    
    Constant Field Values
  - DEFAULT_TAB_MAX_HEIGHT
```
private static final double DEFAULT_TAB_MAX_HEIGHT
```
    See Also:
    
    Constant Field Values
  - STYLE_CLASS_FLOATING
```
public static final java.lang.String STYLE_CLASS_FLOATING
```
    TabPane mode will be changed to floating allowing the TabPane to be placed alongside other control.
    
    See Also:
    
    Constant Field Values
  - tabs
```
private <any> tabs
```
  - selectionModel
```
private <any> selectionModel
```
  - side
```
private <any> side
```
  - tabClosingPolicy
```
private <any> tabClosingPolicy
```
  - rotateGraphic
```
private BooleanProperty rotateGraphic
```
  - tabMinWidth
```
private DoubleProperty tabMinWidth
```
  - tabMaxWidth
```
private DoubleProperty tabMaxWidth
```
    Specifies the maximum width of a tab. This can be used to limit the length of text in tabs. If the tab text is longer than the maximum width the text will be truncated. Setting the max equal to the min will fix the width of the tab. By default the min equals to the max This value can also be set via CSS using -fx-tab-max-width.
  - tabMinHeight
```
private DoubleProperty tabMinHeight
```
  - tabMaxHeight
```
private DoubleProperty tabMaxHeight
```
    The maximum height if the tabs in the TabPane. This can be used to limit the height in tabs. Setting the max equal to the min will fix the height of the tab. By default the min equals to the max. This value can also be set via CSS using -fx-tab-max-height
  - TOP_PSEUDOCLASS_STATE
```
private static final PseudoClass TOP_PSEUDOCLASS_STATE
```
  - BOTTOM_PSEUDOCLASS_STATE
```
private static final PseudoClass BOTTOM_PSEUDOCLASS_STATE
```
  - LEFT_PSEUDOCLASS_STATE
```
private static final PseudoClass LEFT_PSEUDOCLASS_STATE
```
  - RIGHT_PSEUDOCLASS_STATE
```
private static final PseudoClass RIGHT_PSEUDOCLASS_STATE
```
  - tabDragPolicy
```
private <any> tabDragPolicy
```
- Constructor Detail
  - TabPane
```
public TabPane()
```
    Constructs a new TabPane.
  - TabPane
```
public TabPane(Tab... tabs)
```
    Constructs a new TabPane with the given tabs set to show.
    
    Parameters:
    
    tabs - The tabs to display inside the TabPane.
    
    Since:
    
    JavaFX 8u40
- Method Detail
  - getTabs
```
public final <any> getTabs()
```
    The tabs to display in this TabPane. Changing this ObservableList will immediately result in the TabPane updating to display the new contents of this ObservableList.
    
    If the tabs ObservableList changes, the selected tab will remain the previously selected tab, if it remains within this ObservableList. If the previously selected tab is no longer in the tabs ObservableList, the selected tab will become the first tab in the ObservableList.
    
    Returns:
    
    the list of tabs
  - setSelectionModel
```
public final void setSelectionModel(SingleSelectionModel<Tab> value)
```
    Sets the model used for tab selection. By changing the model you can alter how the tabs are selected and which tabs are first or last.
    
    Parameters:
    
    value - the selection model
  - getSelectionModel
```
public final SingleSelectionModel<Tab> getSelectionModel()
```
    Gets the model used for tab selection.
    
    Returns:
    
    the model used for tab selection
  - selectionModelProperty
```
public final <any> selectionModelProperty()
```
    The selection model used for selecting tabs.
    
    See Also:
    
    getSelectionModel(), setSelectionModel(SingleSelectionModel)
  - setSide
```
public final void setSide(Side value)
```
    The position to place the tabs in this TabPane. Whenever this changes the TabPane will immediately update the location of the tabs to reflect this.
    
    Parameters:
    
    value - the side
  - getSide
```
public final Side getSide()
```
    The current position of the tabs in the TabPane. The default position for the tabs is Side.Top.
    
    Returns:
    
    The current position of the tabs in the TabPane.
  - sideProperty
```
public final <any> sideProperty()
```
    The position of the tabs in the TabPane.
    
    See Also:
    
    getSide(), setSide(Side)
  - setTabClosingPolicy
```
public final void setTabClosingPolicy(TabPane.TabClosingPolicy value)
```
    Specifies how the TabPane handles tab closing from an end-users perspective. The options are:
    - TabClosingPolicy.UNAVAILABLE: Tabs can not be closed by the user
    - TabClosingPolicy.SELECTED_TAB: Only the currently selected tab will have the option to be closed, with a graphic next to the tab text being shown. The graphic will disappear when a tab is no longer selected.
    - TabClosingPolicy.ALL_TABS: All tabs will have the option to be closed.
    Refer to the TabPane.TabClosingPolicy enumeration for further details.
    The default closing policy is TabClosingPolicy.SELECTED_TAB
    Parameters:
    
    value - the closing policy
  - getTabClosingPolicy
```
public final TabPane.TabClosingPolicy getTabClosingPolicy()
```
    The closing policy for the tabs.
    
    Returns:
    
    The closing policy for the tabs.
  - tabClosingPolicyProperty
```
public final <any> tabClosingPolicyProperty()
```
    The closing policy for the tabs.
    
    See Also:
    
    getTabClosingPolicy(), setTabClosingPolicy(TabClosingPolicy)
  - setRotateGraphic
```
public final void setRotateGraphic(boolean value)
```
    Specifies whether the graphic inside a Tab is rotated or not, such that it is always upright, or rotated in the same way as the Tab text is.
    
    By default rotateGraphic is set to false, to represent the fact that the graphic isn't rotated, resulting in it always appearing upright. If rotateGraphic is set to true, the graphic will rotate such that it rotates with the tab text.
    
    Parameters:
    
    value - a flag indicating whether to rotate the graphic
  - isRotateGraphic
```
public final boolean isRotateGraphic()
```
    Returns true if the graphic inside a Tab is rotated. The default is false
    
    Returns:
    
    the rotatedGraphic state.
  - rotateGraphicProperty
```
public final BooleanProperty rotateGraphicProperty()
```
    The rotateGraphic state of the tabs in the TabPane.
    
    See Also:
    
    isRotateGraphic(), setRotateGraphic(boolean)
  - setTabMinWidth
```
public final void setTabMinWidth(double value)
```
    The minimum width of the tabs in the TabPane. This can be used to limit the length of text in tabs to prevent truncation. Setting the min equal to the max will fix the width of the tab. By default the min equals to the max. This value can also be set via CSS using -fx-tab-min-width
    
    Parameters:
    
    value - the minimum width of the tabs
  - getTabMinWidth
```
public final double getTabMinWidth()
```
    The minimum width of the tabs in the TabPane.
    
    Returns:
    
    The minimum width of the tabs
  - tabMinWidthProperty
```
public final DoubleProperty tabMinWidthProperty()
```
    The minimum width of the tabs in the TabPane.
    
    See Also:
    
    getTabMinWidth(), setTabMinWidth(double)
  - setTabMaxWidth
```
public final void setTabMaxWidth(double value)
```
    Sets the value of the property tabMaxWidth.
  - getTabMaxWidth
```
public final double getTabMaxWidth()
```
    The maximum width of the tabs in the TabPane.
    
    Returns:
    
    The maximum width of the tabs
  - tabMaxWidthProperty
```
public final DoubleProperty tabMaxWidthProperty()
```
    The maximum width of the tabs in the TabPane.
    
    Returns:
    
    the maximum width property
  - setTabMinHeight
```
public final void setTabMinHeight(double value)
```
    The minimum height of the tabs in the TabPane. This can be used to limit the height in tabs. Setting the min equal to the max will fix the height of the tab. By default the min equals to the max. This value can also be set via CSS using -fx-tab-min-height
    
    Parameters:
    
    value - the minimum height of the tabs
  - getTabMinHeight
```
public final double getTabMinHeight()
```
    The minimum height of the tabs in the TabPane.
    
    Returns:
    
    the minimum height of the tabs
  - tabMinHeightProperty
```
public final DoubleProperty tabMinHeightProperty()
```
    The minimum height of the tab.
    
    See Also:
    
    getTabMinHeight(), setTabMinHeight(double)
  - setTabMaxHeight
```
public final void setTabMaxHeight(double value)
```
    Sets the value of the property tabMaxHeight.
  - getTabMaxHeight
```
public final double getTabMaxHeight()
```
    The maximum height of the tabs in the TabPane.
    
    Returns:
    
    The maximum height of the tabs
  - tabMaxHeightProperty
```
public final DoubleProperty tabMaxHeightProperty()
```
    The maximum height of the tabs in the TabPane.
    
    Returns:
    
    the maximum height of the tabs
  - createDefaultSkin
```
protected Skin<?> createDefaultSkin()
```
    Create a new instance of the default skin for this control. This is called to create a skin for the control if no skin is provided via CSS -fx-skin or set explicitly in a sub-class with setSkin(...).
    
    Overrides:
    
    createDefaultSkin in class Control
    
    Returns:
    
    new instance of default skin for this control. If null then the control will have no skin unless one is provided by css.
  - lookup
```
public Node lookup(java.lang.String selector)
```
  - lookupAll
```
public java.util.Set<Node> lookupAll(java.lang.String selector)
```
  - 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
  - getControlCssMetaData
```
public java.util.List<<any>> getControlCssMetaData()
```
    Overrides:
    
    getControlCssMetaData in class Control
    
    Returns:
    
    unmodifiable list of the controls css styleable properties
    
    Since:
    
    JavaFX 8.0
  - tabDragPolicyProperty
```
public final <any> tabDragPolicyProperty()
```
    The drag policy for the tabs. The policy can be changed dynamically.
    
    Since:
    
    10
    
    See Also:
    
    getTabDragPolicy(), setTabDragPolicy(TabDragPolicy)
  - setTabDragPolicy
```
public final void setTabDragPolicy(TabPane.TabDragPolicy value)
```
    Sets the value of the property tabDragPolicy.
    
    Since:
    
    10
  - getTabDragPolicy
```
public final TabPane.TabDragPolicy getTabDragPolicy()
```
    Gets the value of the property tabDragPolicy.
    
    Since:
    
    10

Class TabPane

Property Summary

Properties inherited from class javafx.scene.control.Control

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class javafx.scene.control.Control

Methods inherited from class java.lang.Object

Property Detail

selectionModel

side

tabClosingPolicy

rotateGraphic

tabMinWidth

tabMaxWidth

tabMinHeight

tabMaxHeight

tabDragPolicy

Field Detail

DEFAULT_TAB_MIN_WIDTH

DEFAULT_TAB_MAX_WIDTH

DEFAULT_TAB_MIN_HEIGHT

DEFAULT_TAB_MAX_HEIGHT

STYLE_CLASS_FLOATING

tabs

selectionModel

side

tabClosingPolicy

rotateGraphic

tabMinWidth

tabMaxWidth

tabMinHeight

tabMaxHeight

TOP_PSEUDOCLASS_STATE

BOTTOM_PSEUDOCLASS_STATE

LEFT_PSEUDOCLASS_STATE

RIGHT_PSEUDOCLASS_STATE

tabDragPolicy

Constructor Detail

TabPane

TabPane

Method Detail

getTabs

setSelectionModel

getSelectionModel

selectionModelProperty

setSide

getSide

sideProperty

setTabClosingPolicy

getTabClosingPolicy

tabClosingPolicyProperty

setRotateGraphic

isRotateGraphic

rotateGraphicProperty

setTabMinWidth

getTabMinWidth

tabMinWidthProperty

setTabMaxWidth

getTabMaxWidth

tabMaxWidthProperty

setTabMinHeight

getTabMinHeight

tabMinHeightProperty

setTabMaxHeight

getTabMaxHeight

tabMaxHeightProperty

createDefaultSkin

lookup

lookupAll

getClassCssMetaData

getControlCssMetaData

tabDragPolicyProperty

setTabDragPolicy

getTabDragPolicy