Tab (JavaFX 2.2)

java.lang.Object
- javafx.scene.control.Tab

All Implemented Interfaces:

EventTarget
```
@DefaultProperty(value="content")
public class Tab
extends java.lang.Object
implements EventTarget
```
Tabs are placed within a TabPane, where each tab represents a single 'page'.

Tabs can contain any Node such as UI controls or groups of nodes added to a layout container.

When the user clicks on a Tab in the TabPane the Tab content becomes visible to the user.

Property Summary

Properties
Type	Property and Description
`BooleanProperty`	`closable` The closable state for this tab.
`ObjectProperty<Node>`	`content` The content associated with the tab.
`ObjectProperty<ContextMenu>`	`contextMenu` The context menu associated with the tab.
`ReadOnlyBooleanProperty`	`disabled` Indicates whether or not this `Tab` is disabled.
`BooleanProperty`	`disable` Sets the disabled state of this tab.
`ObjectProperty<Node>`	`graphic` The graphic in the tab.
`StringProperty`	`id` The id of this tab.
`ObjectProperty<EventHandler<Event>>`	`onClosed` The event handler that is associated with the tab when the tab is closed.
`ObjectProperty<EventHandler<Event>>`	`onSelectionChanged` The event handler that is associated with a selection on the tab.
`ReadOnlyBooleanProperty`	`selected` The currently selected tab.
`StringProperty`	`style` The CSS style string associated to this tab.
`ReadOnlyObjectProperty<TabPane>`	`tabPane` The TabPane that contains this tab.
`StringProperty`	`text` The text shown in the tab.
`ObjectProperty<Tooltip>`	`tooltip` The tooltip associated with this tab.

Field Summary

Fields
Modifier and Type	Field and Description
`static EventType<Event>`	`CLOSED_EVENT` Called when a user closes this tab.
`static EventType<Event>`	`SELECTION_CHANGED_EVENT` Called when the tab becomes selected or unselected.

Constructor Summary

Constructors
Constructor and Description

Tab()
Creates a tab with no title.

Tab(java.lang.String text)
Creates a tab with a text title.

Constructors
Constructor and Description
`Tab()` Creates a tab with no title.
`Tab(java.lang.String text)` Creates a tab with a text title.

Method Summary

Methods
Modifier and Type	Method and Description
`BooleanProperty`	`closableProperty()` The closable state for this tab.
`ObjectProperty<Node>`	`contentProperty()` The content associated with the tab.
`ObjectProperty<ContextMenu>`	`contextMenuProperty()` The context menu associated with the tab.
`ReadOnlyBooleanProperty`	`disabledProperty()` Indicates whether or not this `Tab` is disabled.
`BooleanProperty`	`disableProperty()` Sets the disabled state of this tab.
`Node`	`getContent()` The content associated with the tab.
`ContextMenu`	`getContextMenu()` The context menu associated with the tab.
`Node`	`getGraphic()` The graphic shown in the tab.
`java.lang.String`	`getId()` The id of this tab.
`EventHandler<Event>`	`getOnClosed()` The event handler that is associated with the tab when the tab is closed.
`EventHandler<Event>`	`getOnSelectionChanged()` The event handler that is associated with a selection on the tab.
`ObservableMap<java.lang.Object,java.lang.Object>`	`getProperties()` Returns an observable map of properties on this Tab for use primarily by application developers.
`java.lang.String`	`getStyle()` The CSS style string associated to this tab.
`ObservableList<java.lang.String>`	`getStyleClass()` A list of String identifiers which can be used to logically group Nodes, specifically for an external style engine.
`TabPane`	`getTabPane()` A reference to the TabPane that contains this tab instance.
`java.lang.String`	`getText()` The text shown in the tab.
`Tooltip`	`getTooltip()` The tooltip associated with this tab.
`java.lang.Object`	`getUserData()` Returns a previously set Object property, or null if no such property has been set using the `setUserData(java.lang.Object)` method.
`ObjectProperty<Node>`	`graphicProperty()` The graphic in the tab.
`boolean`	`hasProperties()` Tests if this Tab has properties.
`StringProperty`	`idProperty()` The id of this tab.
`boolean`	`isClosable()` Returns `true` if this tab is closable.
`boolean`	`isDisable()` Returns `true` if this tab is disable.
`boolean`	`isDisabled()` Returns true when the `Tab` `disable` is set to `true` or if the `TabPane` is disabled.
`boolean`	`isSelected()` Represents whether this tab is the currently selected tab, To change the selected Tab use `tabPane.getSelectionModel().select()`
`ObjectProperty<EventHandler<Event>>`	`onClosedProperty()` The event handler that is associated with the tab when the tab is closed.
`ObjectProperty<EventHandler<Event>>`	`onSelectionChangedProperty()` The event handler that is associated with a selection on the tab.
`ReadOnlyBooleanProperty`	`selectedProperty()` The currently selected tab.
`void`	`setClosable(boolean value)` Sets `true` if the tab is closable.
`void`	`setContent(Node value)` The content to show within the main TabPane area.
`void`	`setContextMenu(ContextMenu value)` Specifies the context menu to show when the user right-clicks on the tab.
`void`	`setDisable(boolean value)` Sets the disabled state of this tab.
`void`	`setGraphic(Node value)` Sets the graphic to show in the tab to allow the user to differentiate between the function of each tab.
`void`	`setId(java.lang.String value)` Sets the id of this tab.
`void`	`setOnClosed(EventHandler<Event> value)` Defines a function to be called when the tab is closed.
`void`	`setOnSelectionChanged(EventHandler<Event> value)` Defines a function to be called when a selection changed has occurred on the tab.
`void`	`setStyle(java.lang.String value)` A string representation of the CSS style associated with this tab.
`void`	`setText(java.lang.String value)` Sets the text to show in the tab to allow the user to differentiate between the function of each tab.
`void`	`setTooltip(Tooltip value)` Specifies the tooltip to show when the user hovers over the tab.
`void`	`setUserData(java.lang.Object value)` Convenience method for setting a single Object property that can be retrieved at a later date.
`StringProperty`	`styleProperty()` The CSS style string associated to this tab.
`ReadOnlyObjectProperty<TabPane>`	`tabPaneProperty()` The TabPane that contains this tab.
`StringProperty`	`textProperty()` The text shown in the tab.
`ObjectProperty<Tooltip>`	`tooltipProperty()` The tooltip associated with this tab.

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

- Property Detail
  - id
```
public final StringProperty idProperty
```
    The id of this tab.
    
    See Also:
    getId(), setId(String)
  - style
```
public final StringProperty styleProperty
```
    The CSS style string associated to this tab.
    
    See Also:
    getStyle(), setStyle(String)
  - selected
```
public final ReadOnlyBooleanProperty selectedProperty
```
    The currently selected tab.
    
    See Also:
    isSelected()
  - tabPane
```
public final ReadOnlyObjectProperty<TabPane> tabPaneProperty
```
    The TabPane that contains this tab.
    
    See Also:
    getTabPane()
  - text
```
public final StringProperty textProperty
```
    The text shown in the tab.
    
    See Also:
    getText(), setText(String)
  - graphic
```
public final ObjectProperty<Node> graphicProperty
```
    The graphic in the tab.
    
    Returns:
    The graphic in the tab.
    See Also:
    getGraphic(), setGraphic(Node)
  - content
```
public final ObjectProperty<Node> contentProperty
```
    The content associated with the tab.
    
    See Also:
    getContent(), setContent(Node)
  - contextMenu
```
public final ObjectProperty<ContextMenu> contextMenuProperty
```
    The context menu associated with the tab.
    
    See Also:
    getContextMenu(), setContextMenu(ContextMenu)
  - closable
```
public final BooleanProperty closableProperty
```
    The closable state for this tab.
    
    See Also:
    isClosable(), setClosable(boolean)
  - onSelectionChanged
```
public final ObjectProperty<EventHandler<Event>> onSelectionChangedProperty
```
    The event handler that is associated with a selection on the tab.
    
    See Also:
    getOnSelectionChanged(), setOnSelectionChanged(EventHandler)
  - onClosed
```
public final ObjectProperty<EventHandler<Event>> onClosedProperty
```
    The event handler that is associated with the tab when the tab is closed.
    
    See Also:
    getOnClosed(), setOnClosed(EventHandler)
  - tooltip
```
public final ObjectProperty<Tooltip> tooltipProperty
```
    The tooltip associated with this tab.
    
    See Also:
    getTooltip(), setTooltip(Tooltip)
  - disable
```
public final BooleanProperty disableProperty
```
    Sets the disabled state of this tab. A disable tab is no longer interactive or traversable, but the contents remain interactive. A disable tab can be selected using TabPane.getSelectionModel().
    
    Since:
    
    2.2
    
    Default value:
    
    false
    
    See Also:
    isDisable(), setDisable(boolean)
  - disabled
```
public final ReadOnlyBooleanProperty disabledProperty
```
    Indicates whether or not this Tab is disabled. A Tab will become disabled if disable is set to true on either itself or if the TabPane is disabled.
    
    Since:
    
    2.2
    
    Default value:
    
    false
    
    See Also:
    isDisabled()
- Field Detail
  - SELECTION_CHANGED_EVENT
```
public static final EventType<Event> SELECTION_CHANGED_EVENT
```
    Called when the tab becomes selected or unselected.
  - CLOSED_EVENT
```
public static final EventType<Event> CLOSED_EVENT
```
    Called when a user closes this tab. This is useful for freeing up memory.
- Constructor Detail
  - Tab
```
public Tab()
```
    Creates a tab with no title.
  - Tab
```
public Tab(java.lang.String text)
```
    Creates a tab with a text title.
    
    Parameters:
    text - The title of the tab.
- Method Detail
  - setId
```
public final void setId(java.lang.String value)
```
    Sets the id of this tab. This simple string identifier is useful for finding a specific Tab within the TabPane. The default value is null.
  - getId
```
public final java.lang.String getId()
```
    The id of this tab.
    
    Returns:
    The id of the tab.
  - idProperty
```
public final StringProperty idProperty()
```
    The id of this tab.
    
    See Also:
    getId(), setId(String)
  - setStyle
```
public final void setStyle(java.lang.String value)
```
    A string representation of the CSS style associated with this tab. This is analogous to the "style" attribute of an HTML element. Note that, like the HTML style attribute, this variable contains style properties and values and not the selector portion of a style rule.
    Parsing this style might not be supported on some limited platforms. It is recommended to use a standalone CSS file instead.
  - getStyle
```
public final java.lang.String getStyle()
```
    The CSS style string associated to this tab.
    
    Returns:
    The CSS style string associated to this tab.
  - styleProperty
```
public final StringProperty styleProperty()
```
    The CSS style string associated to this tab.
    
    See Also:
    getStyle(), setStyle(String)
  - isSelected
```
public final boolean isSelected()
```
    Represents whether this tab is the currently selected tab, To change the selected Tab use tabPane.getSelectionModel().select()
  - selectedProperty
```
public final ReadOnlyBooleanProperty selectedProperty()
```
    The currently selected tab.
    
    See Also:
    isSelected()
  - getTabPane
```
public final TabPane getTabPane()
```
    A reference to the TabPane that contains this tab instance.
  - tabPaneProperty
```
public final ReadOnlyObjectProperty<TabPane> tabPaneProperty()
```
    The TabPane that contains this tab.
    
    See Also:
    getTabPane()
  - setText
```
public final void setText(java.lang.String value)
```
    Sets the text to show in the tab to allow the user to differentiate between the function of each tab. The text is always visible
  - getText
```
public final java.lang.String getText()
```
    The text shown in the tab.
    
    Returns:
    The text shown in the tab.
  - textProperty
```
public final StringProperty textProperty()
```
    The text shown in the tab.
    
    See Also:
    getText(), setText(String)
  - setGraphic
```
public final void setGraphic(Node value)
```
    Sets the graphic to show in the tab to allow the user to differentiate between the function of each tab. By default the graphic does not rotate based on the TabPane.tabPosition value, but it can be set to rotate by setting TabPane.rotateGraphic to true.
  - getGraphic
```
public final Node getGraphic()
```
    The graphic shown in the tab.
    
    Returns:
    The graphic shown in the tab.
  - graphicProperty
```
public final ObjectProperty<Node> graphicProperty()
```
    The graphic in the tab.
    
    Returns:
    The graphic in the tab.
    See Also:
    getGraphic(), setGraphic(Node)
  - setContent
```
public final void setContent(Node value)
```
    The content to show within the main TabPane area. The content can be any Node such as UI controls or groups of nodes added to a layout container.
  - getContent
```
public final Node getContent()
```
    The content associated with the tab.
    
    Returns:
    The content associated with the tab.
  - contentProperty
```
public final ObjectProperty<Node> contentProperty()
```
    The content associated with the tab.
    
    See Also:
    getContent(), setContent(Node)
  - setContextMenu
```
public final void setContextMenu(ContextMenu value)
```
    Specifies the context menu to show when the user right-clicks on the tab.
  - getContextMenu
```
public final ContextMenu getContextMenu()
```
    The context menu associated with the tab.
    
    Returns:
    The context menu associated with the tab.
  - contextMenuProperty
```
public final ObjectProperty<ContextMenu> contextMenuProperty()
```
    The context menu associated with the tab.
    
    See Also:
    getContextMenu(), setContextMenu(ContextMenu)
  - setClosable
```
public final void setClosable(boolean value)
```
    Sets true if the tab is closable. If this is set to false, then regardless of the TabClosingPolicy, it will not be possible for the user to close this tab. Therefore, when this property is false, no 'close' button will be shown on the tab. The default is true.
  - isClosable
```
public final boolean isClosable()
```
    Returns true if this tab is closable.
    
    Returns:
    true if the tab is closable.
  - closableProperty
```
public final BooleanProperty closableProperty()
```
    The closable state for this tab.
    
    See Also:
    isClosable(), setClosable(boolean)
  - setOnSelectionChanged
```
public final void setOnSelectionChanged(EventHandler<Event> value)
```
    Defines a function to be called when a selection changed has occurred on the tab.
  - getOnSelectionChanged
```
public final EventHandler<Event> getOnSelectionChanged()
```
    The event handler that is associated with a selection on the tab.
    
    Returns:
    The event handler that is associated with a tab selection.
  - onSelectionChangedProperty
```
public final ObjectProperty<EventHandler<Event>> onSelectionChangedProperty()
```
    The event handler that is associated with a selection on the tab.
    
    See Also:
    getOnSelectionChanged(), setOnSelectionChanged(EventHandler)
  - setOnClosed
```
public final void setOnClosed(EventHandler<Event> value)
```
    Defines a function to be called when the tab is closed.
  - getOnClosed
```
public final EventHandler<Event> getOnClosed()
```
    The event handler that is associated with the tab when the tab is closed.
    
    Returns:
    The event handler that is associated with the tab when the tab is closed.
  - onClosedProperty
```
public final ObjectProperty<EventHandler<Event>> onClosedProperty()
```
    The event handler that is associated with the tab when the tab is closed.
    
    See Also:
    getOnClosed(), setOnClosed(EventHandler)
  - setTooltip
```
public final void setTooltip(Tooltip value)
```
    Specifies the tooltip to show when the user hovers over the tab.
  - getTooltip
```
public final Tooltip getTooltip()
```
    The tooltip associated with this tab.
    
    Returns:
    The tooltip associated with this tab.
  - tooltipProperty
```
public final ObjectProperty<Tooltip> tooltipProperty()
```
    The tooltip associated with this tab.
    
    See Also:
    getTooltip(), setTooltip(Tooltip)
  - setDisable
```
public final void setDisable(boolean value)
```
    Sets the disabled state of this tab.
    
    Parameters:
    value - the state to set this tab
    Since:
    
    2.2
    
    Default value:
    
    false
  - isDisable
```
public final boolean isDisable()
```
    Returns true if this tab is disable.
    
    Since:
    
    2.2
  - disableProperty
```
public final BooleanProperty disableProperty()
```
    Sets the disabled state of this tab. A disable tab is no longer interactive or traversable, but the contents remain interactive. A disable tab can be selected using TabPane.getSelectionModel().
    
    Since:
    
    2.2
    
    Default value:
    
    false
    
    See Also:
    isDisable(), setDisable(boolean)
  - isDisabled
```
public final boolean isDisabled()
```
    Returns true when the Tab disable is set to true or if the TabPane is disabled.
    
    Since:
    
    2.2
  - disabledProperty
```
public final ReadOnlyBooleanProperty disabledProperty()
```
    Indicates whether or not this Tab is disabled. A Tab will become disabled if disable is set to true on either itself or if the TabPane is disabled.
    
    Since:
    
    2.2
    
    Default value:
    
    false
    
    See Also:
    isDisabled()
  - getProperties
```
public final ObservableMap<java.lang.Object,java.lang.Object> getProperties()
```
    Returns an observable map of properties on this Tab for use primarily by application developers.
    
    Returns:
    an observable map of properties on this Tab for use primarily by application developers
    Since:
    
    2.2
  - hasProperties
```
public boolean hasProperties()
```
    Tests if this Tab has properties.
    
    Returns:
    true if this tab has properties.
    Since:
    
    2.2
  - setUserData
```
public void setUserData(java.lang.Object value)
```
    Convenience method for setting a single Object property that can be retrieved at a later date. This is functionally equivalent to calling the getProperties().put(Object key, Object value) method. This can later be retrieved by calling getUserData().
    
    Parameters:
    value - The value to be stored - this can later be retrieved by calling getUserData().
    Since:
    
    2.2
  - getUserData
```
public java.lang.Object getUserData()
```
    Returns a previously set Object property, or null if no such property has been set using the setUserData(java.lang.Object) method.
    
    Returns:
    The Object that was previously set, or null if no property has been set or if null was set.
    Since:
    
    2.2
  - getStyleClass
```
public ObservableList<java.lang.String> getStyleClass()
```
    A list of String identifiers which can be used to logically group Nodes, specifically for an external style engine. This variable is analogous to the "class" attribute on an HTML element and, as such, each element of the list is a style class to which this Node belongs.
    
    See Also:
    CSS3 class selectors

Class Tab

Property Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Property Detail

id

style

selected

tabPane

text

graphic

content

contextMenu

closable

onSelectionChanged

onClosed

tooltip

disable

disabled

Field Detail

SELECTION_CHANGED_EVENT

CLOSED_EVENT

Constructor Detail

Tab

Tab

Method Detail

setId

getId

idProperty

setStyle

getStyle

styleProperty

isSelected

selectedProperty

getTabPane

tabPaneProperty

setText

getText

textProperty

setGraphic

getGraphic

graphicProperty

setContent

getContent

contentProperty

setContextMenu

getContextMenu

contextMenuProperty

setClosable

isClosable

closableProperty

setOnSelectionChanged

getOnSelectionChanged

onSelectionChangedProperty

setOnClosed

getOnClosed

onClosedProperty

setTooltip

getTooltip

tooltipProperty

setDisable

isDisable

disableProperty

isDisabled

disabledProperty

getProperties

hasProperties

setUserData

getUserData

getStyleClass