Module  javafx.controls
软件包  javafx.scene.control

Class Tab

  • All Implemented Interfaces:
    StyleableEventTarget


    @DefaultProperty("content")
    @IDProperty("id")
    public class Tab
    extends Object
    implements EventTarget, Styleable

    标签放置在一个TabPane ,其中每个选项卡表示单个“页面”。

    标签可以包含任何Node ,如UI控件或添加到布局容器的节点组。

    当用户点击TabPane中的Tab时,Tab内容对用户可见。

    从以下版本开始:
    JavaFX 2.0
    • 字段详细信息

      • SELECTION_CHANGED_EVENT

        public static final EventType<Event> SELECTION_CHANGED_EVENT

        当选项卡被选中或未选择时调用。

      • CLOSED_EVENT

        public static final EventType<Event> CLOSED_EVENT

        当用户关闭此选项卡时调用。 这对于释放内存很有用。

      • TAB_CLOSE_REQUEST_EVENT

        public static final EventType<Event> TAB_CLOSE_REQUEST_EVENT
        当有外部请求关闭此Tab 安装的事件处理程序可以通过消耗接收的事件来阻止标签关闭。
        从以下版本开始:
        JavaFX 8.0
    • 构造方法详细信息

      • Tab

        public Tab​()
        创建没有标题的选项卡。
      • Tab

        public Tab​(String text)
        创建一个带有文本标题的选项卡。
        参数
        text - 标签的标题。
      • Tab

        public Tab​(String text,
                   Node content)
        创建一个带有文本标题和指定内容节点的选项卡。
        参数
        text - 标签的标题。
        content - 选项卡的内容。
        从以下版本开始:
        JavaFX 8u40
    • 方法详细信息

      • setId

        public final void setId​(String value)
        设置此选项卡的ID。 这个简单的字符串标识符可用于查找TabPane的特定标签。 默认值为null
        参数
        value - 此选项卡的ID
      • getId

        public final String getId​()
        此选项卡的ID。
        Specified by:
        getId在接口 Styleable
        结果
        标签的ID。
      • idProperty

        public final StringProperty idProperty​()
        此选项卡的ID。
        结果
        该标签的id属性
      • setStyle

        public final void setStyle​(String value)
        与此选项卡相关联的CSS样式的字符串表示形式。 这类似于HTML元素的“样式”属性。 请注意,像HTML样式属性一样,此变量包含样式属性和值,而不包含样式规则的选择器部分。

        在某些有限的平台上可能不支持解析此样式。 建议使用独立的CSS文件。

        参数
        value - 风格字符串
      • getStyle

        public final String getStyle​()
        与此选项卡关联的CSS样式字符串。
        Specified by:
        getStyle在接口 Styleable
        结果
        与此选项卡关联的CSS样式字符串。
      • isSelected

        public final boolean isSelected​()

        表示此选项卡是否为当前选定的选项卡,要更改选定的选项卡,请使用tabPane.getSelectionModel().select()

        结果
        如果选择则为真
      • getTabPane

        public final TabPane getTabPane​()

        对包含此选项卡实例的TabPane的引用。

        结果
        TabPane
      • setText

        public final void setText​(String value)

        将选项卡中显示的文本设置为允许用户区分每个选项卡的功能。 文字始终可见

        参数
        value - 文本字符串
      • getText

        public final String getText​()
        选项卡中显示的文本。
        结果
        选项卡中显示的文本。
      • setGraphic

        public final void setGraphic​(Node value)

        将图形设置为在标签中显示,以允许用户区分每个选项卡的功能。 默认情况下,图形不会基于TabPane.tabPosition值进行旋转,但可以通过将TabPane.rotateGraphic设置为true来将其设置为旋转。

        参数
        value - 图形节点
      • getGraphic

        public final Node getGraphic​()
        标签中显示的图形。
        结果
        标签中显示的图形。
      • setContent

        public final void setContent​(Node value)

        内容显示在主TabPane区域内。 内容可以是任何节点,如UI控件或添加到布局容器的节点组。

        参数
        value - 内容节点
      • getContent

        public final Node getContent​()

        与标签相关的内容。

        结果
        与标签相关的内容。
      • setContextMenu

        public final void setContextMenu​(ContextMenu value)

        指定上下文菜单,以显示用户在选项卡上的右键单击。

        参数
        value - 上下文菜单
      • getContextMenu

        public final ContextMenu getContextMenu​()
        与选项卡关联的上下文菜单。
        结果
        与选项卡关联的上下文菜单。
      • setClosable

        public final void setClosable​(boolean value)

        如果选项卡是可关闭的,请设置true 如果设置为false ,则无论false如何,用户将无法关闭此选项卡。 因此,当此属性为false ,标签上不会显示“关闭”按钮。 默认值为true

        参数
        value - 可关闭的值
      • isClosable

        public final boolean isClosable​()
        如果此选项卡可关闭,则返回 true
        结果
        true如果选项卡是可关闭的。
      • setOnSelectionChanged

        public final void setOnSelectionChanged​(EventHandler<Event> value)
        定义在选项卡上发生选择更改时要调用的函数。
        参数
        value - 选择更改的事件处理程序
      • getOnSelectionChanged

        public final EventHandler<Event> getOnSelectionChanged​()
        与选项卡上的选择相关联的事件处理程序。
        结果
        与选项卡选择相关联的事件处理程序。
      • setOnClosed

        public final void setOnClosed​(EventHandler<Event> value)
        定义标签关闭时要调用的函数。
        参数
        value - 关闭事件处理程序
      • getOnClosed

        public final EventHandler<Event> getOnClosed​()
        当选项卡关闭时与选项卡关联的事件处理程序。
        结果
        当选项卡关闭时与选项卡关联的事件处理程序。
      • setTooltip

        public final void setTooltip​(Tooltip value)

        指定工具提示,以显示用户何时悬停在选项卡上。

        参数
        value - 刀尖值
      • getTooltip

        public final Tooltip getTooltip​()
        与此选项卡关联的工具提示。
        结果
        与此选项卡关联的工具提示。
      • setDisable

        public final void setDisable​(boolean value)
        设置此选项卡的禁用状态。
        Default value:
        参数
        value - 设置此选项卡的状态
        从以下版本开始:
        JavaFX 2.2
      • isDisable

        public final boolean isDisable​()
        如果此选项卡 true禁用 true则返回 true
        结果
        如果此选项卡禁用,则为true
        从以下版本开始:
        JavaFX 2.2
      • isDisabled

        public final boolean isDisabled​()
        当返回true Tab disable设置为 true ,或者如果 TabPane被禁用。
        结果
        如果禁用TabPane,则为true
        从以下版本开始:
        JavaFX 2.2
      • disabledProperty

        public final ReadOnlyBooleanProperty disabledProperty​()
        表示此Tab是否被禁用。 一个Tab如果将被禁用disable设置为true上自行或如果TabPane被禁用。
        Default value:
        从以下版本开始:
        JavaFX 2.2
        另请参见:
        isDisabled()
      • getOnCloseRequest

        public EventHandler<Event> getOnCloseRequest​()
        获取属性onCloseRequest的值。
        Property description:
        当有外部请求关闭此Tab 安装的事件处理程序可以通过消耗接收的事件来阻止标签关闭。
        从以下版本开始:
        JavaFX 8.0
      • setOnCloseRequest

        public void setOnCloseRequest​(EventHandler<Event> value)
        设置属性onCloseRequest的值。
        Property description:
        当有外部请求关闭这个Tab 安装的事件处理程序可以通过消耗接收的事件来阻止标签关闭。
        从以下版本开始:
        JavaFX 8.0
      • getProperties

        public final ObservableMap<Object,Object> getProperties​()
        返回此选项卡上属性的可观察图,主要由应用程序开发人员使用。
        结果
        该Tab上的属性的可观察地图主要由应用程序开发人员使用
        从以下版本开始:
        JavaFX 2.2
      • hasProperties

        public boolean hasProperties​()
        测试此选项卡是否具有属性。
        结果
        如果此选项卡具有属性,则为true
        从以下版本开始:
        JavaFX 2.2
      • setUserData

        public void setUserData​(Object value)
        用于设置可以在以后检索的单个Object属性的便利方法。 这在功能上等同于调用getProperties()。put(Object key,Object value)方法。 这可以稍后通过调用getUserData()检索。
        参数
        value - 要存储的值 - 以后可以通过调用 getUserData()来检索。
        从以下版本开始:
        JavaFX 2.2
      • getUserData

        public Object getUserData​()
        返回先前设置的Object属性,如果没有使用 setUserData(java.lang.Object)方法设置此属性,则返回null。
        结果
        先前设置的对象,如果没有设置属性或设置为null,则为null。
        从以下版本开始:
        JavaFX 2.2
      • getStyleClass

        public ObservableList<String> getStyleClass​()
        可用于逻辑组合节点的字符串标识符列表,专门用于外部样式引擎。 该变量类似于HTML元素上的“类”属性,因此列表的每个元素都是此节点所属的样式类。
        Specified by:
        getStyleClass在接口 Styleable
        结果
        可用于逻辑组合节点的字符串标识符列表,专门用于外部样式引擎
        另请参见:
        CSS3 class selectors
      • buildEventDispatchChain

        public EventDispatchChain buildEventDispatchChain​(EventDispatchChain tail)
        为此目标构建事件调度链。 事件调度链包含可能对处理针对这个EventTarget的事件感兴趣的事件调度EventTarget 此事件目标不会自动添加到链中,因此如果要处理事件,则需要为链接添加一个EventDispatcher

        在事件目标是某些层次结构的一部分的情况下,它的链通常是从从层次结构的根被收集到事件目标的事件分派器构建的。

        事件调度链是通过修改提供的初始事件调度链来构建的。 返回的链应该在其末端具有初始链,所以调度员应该放在初始链上。

        调用者不应该假定初始链条保持不变,也不会返回值引用不同的链。

        Specified by:
        buildEventDispatchChain在接口 EventTarget
        参数
        tail - 建立起来的初始链
        结果
        此目标的结果事件调度链
      • getTypeSelector

        public String getTypeSelector​()
        这种Styleable的类型用于选择器匹配。 这类似于HTML中的“元素”。 CSS Type Selector )。
        Specified by:
        getTypeSelector在接口 Styleable
        结果
        “标签”
        从以下版本开始:
        JavaFX 8.0
      • getStyleableParent

        public Styleable getStyleableParent​()
        返回此Styleable的父项,如果没有父项则返回null。
        Specified by:
        getStyleableParent在接口 Styleable
        结果
        getTabPane()
        从以下版本开始:
        JavaFX 8.0
      • getPseudoClassStates

        public final ObservableSet<PseudoClass> getPseudoClassStates​()
        返回此Styleable的伪类状态。 CSS假定此集是只读的。
        Specified by:
        getPseudoClassStates在接口 Styleable
        结果
        伪类状态
        从以下版本开始:
        JavaFX 8.0
      • getCssMetaData

        public List<CssMetaData<? extends Styleable,?>> getCssMetaData​()
        这个样式的CssMetaData。 这可以作为不可修改的列表返回。
        Specified by:
        getCssMetaData在接口 Styleable
        结果
        CssMetaData
        从以下版本开始:
        JavaFX 8.0
      • getClassCssMetaData

        public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData​()
        结果
        与此类相关联的CssMetaData可能包括其类的CssMetaData。
        从以下版本开始:
        JavaFX 8.0