Package javafx.scene.control

Class Tab

java.lang.Object
javafx.scene.control.Tab
All Implemented Interfaces:
Styleable, EventTarget
@DefaultProperty("content") public class Tab extends Object implements EventTarget, Styleable

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.

Since:
JavaFX 2.0

  • Property Details

  • Field Details

    • 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.

    • TAB_CLOSE_REQUEST_EVENT

      public static final EventType<Event> TAB_CLOSE_REQUEST_EVENT
      Called when there is an external request to close this Tab. The installed event handler can prevent tab closing by consuming the received event.
      Since:
      JavaFX 8.0

  • Constructor Details

    • Tab

      public Tab()
      Creates a tab with no title.

    • Tab

      public Tab(String text)
      Creates a tab with a text title.
      Parameters:
      text - The title of the tab.

    • Tab

      public Tab(String text, Node content)
      Creates a tab with a text title and the specified content node.
      Parameters:
      text - The title of the tab.
      content - The content of the tab.
      Since:
      JavaFX 8u40

  • Method Details

    • setId

      public final void setId(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 String getId()
      The id of this tab.
      Specified by:
      getId in interface Styleable
      Returns:
      The id of the tab.

    • idProperty

      public final StringProperty idProperty()
      The id of this tab.

    • setStyle

      public final void setStyle(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 String getStyle()
      The CSS style string associated to this tab.
      Specified by:
      getStyle in interface Styleable
      Returns:
      The CSS style string associated to this tab.

    • styleProperty

      public final StringProperty styleProperty()
      The CSS style string associated to this tab.
      Returns:
      the style property
      See Also:

    • 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.
      Returns:
      the selected property
      See Also:

    • 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.
      Returns:
      the tabPane property
      See Also:

    • setText

      public final void setText(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 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.
      Returns:
      the text property
      See Also:

    • 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:

    • 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.

      Returns:
      the content property
      See Also:

    • 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.

    • 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.
      Returns:
      the onSelectionChanged property
      See Also:

    • 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.
      Returns:
      the onClosed property
      See Also:

    • setDisable

      public final void setDisable(boolean value)
      Sets the disabled state of this tab.
      Default value:
      false
      Parameters:
      value - the state to set this tab
      Since:
      JavaFX 2.2

    • isDisable

      public final boolean isDisable()
      Returns true if this tab is disable.
      Since:
      JavaFX 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().
      Default value:
      false
      Returns:
      the disable property
      Since:
      JavaFX 2.2
      See Also:

    • isDisabled

      public final boolean isDisabled()
      Returns true when the Tab disable is set to true or if the TabPane is disabled.
      Since:
      JavaFX 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.
      Default value:
      false
      Returns:
      the disabled property
      Since:
      JavaFX 2.2
      See Also:

    • onCloseRequestProperty

      public final ObjectProperty<EventHandler<Event>> onCloseRequestProperty()
      Called when there is an external request to close this Tab. The installed event handler can prevent tab closing by consuming the received event.
      Returns:
      the onCloseRequest property
      Since:
      JavaFX 8.0
      See Also:

    • getOnCloseRequest

      public EventHandler<Event> getOnCloseRequest()
      Gets the value of the onCloseRequest property.
      Property description:
      Called when there is an external request to close this Tab. The installed event handler can prevent tab closing by consuming the received event.
      Returns:
      the value of the onCloseRequest property
      Since:
      JavaFX 8.0
      See Also:

    • setOnCloseRequest

      public void setOnCloseRequest(EventHandler<Event> value)
      Sets the value of the onCloseRequest property.
      Property description:
      Called when there is an external request to close this Tab. The installed event handler can prevent tab closing by consuming the received event.
      Parameters:
      value - the value for the onCloseRequest property
      Since:
      JavaFX 8.0
      See Also:

    • getProperties

      public final ObservableMap<Object,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:
      JavaFX 2.2

    • hasProperties

      public boolean hasProperties()
      Tests if this Tab has properties.
      Returns:
      true if this tab has properties.
      Since:
      JavaFX 2.2

    • setUserData

      public void setUserData(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:
      JavaFX 2.2

    • getUserData

      public 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:
      JavaFX 2.2

    • getStyleClass

      public ObservableList<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.
      Specified by:
      getStyleClass in interface Styleable
      See Also: