Класс Tab
- javafx.scene.control.Tab
Все реализованные интерфейсы:
@DefaultProperty(value="content") @IDProperty(value="id") public class Tab extends Object implements EventTarget, Styleable
Вкладки размещаются внутри TabPane, где каждая вкладка представляет собой отдельную «страницу».
Вкладки могут содержать любые Node, такие как элементы управления пользовательского интерфейса или группы узлов, добавленных в контейнер макета.
При нажатии пользователем на вкладку в TabPane содержимое вкладки становится видимым для пользователя.
С:
JavaFX 2.0
-
Краткое описание свойств
Все методыМетоды экземпляраКонкретные методы Тип Свойство и описание BooleanPropertyclosableСостояние закрываемости для этой вкладки.ObjectProperty<Node>contentСодержимое, связанное с вкладкой.ObjectProperty<ContextMenu>contextMenuКонтекстное меню, связанное с вкладкой.ReadOnlyBooleanPropertydisabledУказывает, отключена ли этаTab.BooleanPropertydisableУстанавливает состояние отключения этой вкладки.ObjectProperty<Node>graphicГрафика в вкладке.StringPropertyidИдентификатор этой вкладки.ObjectProperty<EventHandler<Event>>onClosedОбработчик событий, связанный с вкладкой при закрытии вкладки.ObjectProperty<EventHandler<Event>>onCloseRequestВызывается при внешнем запросе о закрытии этойTab.ObjectProperty<EventHandler<Event>>onSelectionChangedОбработчик событий, связанный с выбором на вкладке.ReadOnlyBooleanPropertyselectedТекущая выбранная вкладка.StringPropertystyleСтрока CSS-стиля, связанная с этой вкладкой.ReadOnlyObjectProperty<TabPane>tabPaneTabPane, содержащий эту вкладку.StringPropertytextТекст, отображаемый на вкладке.ObjectProperty<Tooltip>tooltipПодсказка, связанная с этой вкладкой.
-
Краткое описание полей
Поля Модификатор и тип Поле и описание static EventType<Event>CLOSED_EVENTВызывается при закрытии этой вкладки пользователем.static EventType<Event>SELECTION_CHANGED_EVENTВызывается, когда вкладка становится выбранной или не выбранной.static EventType<Event>TAB_CLOSE_REQUEST_EVENTВызывается при внешнем запросе о закрытии этойTab.
-
Краткое описание методов
Все методыСтатические методыМетоды экземпляраКонкретные методы Модификатор и тип Метод и описание BooleanPropertyclosableProperty()Состояние закрытия для этой вкладки.ObjectProperty<Node>contentProperty()Контент, связанный с вкладкой.ObjectProperty<ContextMenu>contextMenuProperty()Контекстное меню, связанное с вкладкой.ReadOnlyBooleanPropertydisabledProperty()Указывает, отключена ли этаTab.BooleanPropertydisableProperty()Устанавливает состояние отключения этой вкладки.static List<CssMetaData<? extends Styleable,?>>getClassCssMetaData()NodegetContent()Контент, связанный с вкладкой.ContextMenugetContextMenu()Контекстное меню, связанное с вкладкой.List<CssMetaData<? extends Styleable,?>>getCssMetaData()CssMetaData этого Styleable.NodegetGraphic()Графика, отображаемая во вкладке.StringgetId()Идентификатор этой вкладки.EventHandler<Event>getOnClosed()Обработчик событий, связанный с вкладкой при её закрытии.EventHandler<Event>getOnCloseRequest()Получает значение свойства onCloseRequest.EventHandler<Event>getOnSelectionChanged()Обработчик событий, связанный с выбором на вкладке.ObservableMap<Object,Object>getProperties()Возвращает наблюдаемое отображение свойств этой вкладки в основном для разработчиков приложений.ObservableSet<PseudoClass>getPseudoClassStates()Возвращает состояние псевдокласса этого Styleable.StringgetStyle()Строка CSS-стиля, связанная с этой вкладкой.StyleablegetStyleableParent()Возвращает родителя этого Styleable или null, если родителя нет.ObservableList<String>getStyleClass()Список идентификаторов строк, которые могут использоваться для логической группировки узлов, в частности, для внешнего механизма стилей.TabPanegetTabPane()Ссылка на TabPane, содержащую этот экземпляр вкладки.StringgetText()Текст, отображаемый во вкладке.TooltipgetTooltip()Подсказка, связанная с этой вкладкой.StringgetTypeSelector()Тип этойStyleable, используемый для сопоставления селекторов.ObjectgetUserData()Возвращает ранее заданное свойство Object или null, если такое свойство не было установлено с помощью методаsetUserData(java.lang.Object).ObjectProperty<Node>graphicProperty()Графика во вкладке.booleanhasProperties()Проверяет, есть ли у этой вкладки свойства.StringPropertyidProperty()Идентификатор этой вкладки.booleanisClosable()Возвращает значение true, если эта вкладка может быть закрыта.booleanisDisable()Возвращает true, если эта вкладка отключена.booleanisDisabled()booleanisSelected()Представляет, является ли эта вкладка текущей выбранной вкладкой. Для изменения выбранной вкладки используйтеtabPane.getSelectionModel().select()ObjectProperty<EventHandler<Event>>onClosedProperty()Обработчик событий, связанный с вкладкой при её закрытии.ObjectProperty<EventHandler<Event>>onCloseRequestProperty()Вызывается при внешнем запросе на закрытие этойTab.ObjectProperty<EventHandler<Event>>onSelectionChangedProperty()Обработчик событий, связанный с выбором на вкладке.ReadOnlyBooleanPropertyselectedProperty()Текущая выбранная вкладка.voidsetClosable(boolean value)Устанавливает значение true, если вкладка может быть закрыта.voidsetContent(Node value)Контент для отображения в области основного TabPane.voidsetContextMenu(ContextMenu value)Определяет контекстное меню, отображаемое при нажатии правой кнопкой мыши на вкладке.voidsetDisable(boolean value)Устанавливает состояние отключения этой вкладки.voidsetGraphic(Node value)Устанавливает графику для отображения на вкладке, позволяя пользователю различать функции каждой вкладки.voidsetId(String value)Устанавливает идентификатор этой вкладки.voidsetOnClosed(EventHandler<Event> value)Определяет функцию, которая вызывается при закрытии вкладки.voidsetOnCloseRequest(EventHandler<Event> value)Устанавливает значение свойства onCloseRequest.voidsetOnSelectionChanged(EventHandler<Event> value)Определяет функцию, которая вызывается при изменении выбора на вкладке.voidsetStyle(String value)Строковое представление CSS-стиля, связанного с этой вкладкой.voidsetText(String value)Устанавливает текст для отображения на вкладке, позволяя пользователю различать функции каждой вкладки.voidsetTooltip(Tooltip value)Определяет подсказку, отображаемую при наведении курсора на вкладку.voidsetUserData(Object value)Удобный метод для установки одного свойства Object, которое может быть получено впоследствии.StringPropertystyleProperty()Строка CSS-стиля, связанная с этой вкладкой.ReadOnlyObjectProperty<TabPane>tabPaneProperty()TabPane, содержащий эту вкладку.StringPropertytextProperty()Текст, отображаемый во вкладке.ObjectProperty<Tooltip>tooltipProperty()Подсказка, связанная с этой вкладкой.
-
Подробное описание свойства
-
id
public final StringProperty idProperty
Идентификатор этой вкладки.
-
style
public final StringProperty styleProperty
Строка CSS-стилей, связанная с этой вкладкой.См. также:
-
selected
public final ReadOnlyBooleanProperty selectedProperty
Текущая выбранная вкладка.См. также:
-
tabPane
public final ReadOnlyObjectProperty<TabPane> tabPaneProperty
Панель вкладок, содержащая эту вкладку.См. также:
-
text
public final StringProperty textProperty
Текст, отображаемый на вкладке.См. также:
-
graphic
public final ObjectProperty<Node> graphicProperty
Графика на вкладке.См. также:
-
content
public final ObjectProperty<Node> contentProperty
Содержимое, связанное с вкладкой.
См. также:
-
contextMenu
public final ObjectProperty<ContextMenu> contextMenuProperty
Контекстное меню, связанное с вкладкой.См. также:
-
closable
public final BooleanProperty closableProperty
Состояние возможности закрытия для этой вкладки.См. также:
-
onSelectionChanged
public final ObjectProperty<EventHandler<Event>> onSelectionChangedProperty
Обработчик событий, связанный с выбором вкладки.
-
onClosed
public final ObjectProperty<EventHandler<Event>> onClosedProperty
Обработчик событий, связанный с закрытием вкладки.См. также:
-
tooltip
public final ObjectProperty<Tooltip> tooltipProperty
Подсказка, связанная с этой вкладкой.См. также:
-
disable
public final BooleanProperty disableProperty
Устанавливает состояние недоступности этой вкладки. Недоступная вкладка больше не является интерактивной или доступной для навигации, но содержимое остается интерактивным. Недоступную вкладку можно выбрать, используяTabPane.getSelectionModel().
-
disabled
public final ReadOnlyBooleanProperty disabledProperty
Указывает, заблокирована ли этаTab. Вкладка станет недоступной, еслиdisableустановлено в значениеtrue, либо если сама вкладка или панель вкладок недоступны.
-
onCloseRequest
public final ObjectProperty<EventHandler<Event>> onCloseRequestProperty
Вызывается при внешнем запросе на закрытие этойTab. Установленный обработчик событий может предотвратить закрытие вкладки, обработанный полученное событие.С:
JavaFX 8.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- Заголовок вкладки.С:
JavaFX 8u40
-
-
Подробное описание методов
-
setId
public final void setId(String value)
Устанавливает идентификатор (id) этой вкладки. Этот простой строковый идентификатор полезен для поиска конкретной вкладки вTabPane. Значение по умолчанию —null.
-
getId
public final String getId()
Идентификатор (id) этой вкладки.
-
idProperty
public final StringProperty idProperty()
Идентификатор (id) этой вкладки.
-
setStyle
public final void setStyle(String value)
Строковое представление CSS-стиля, связанного с этой вкладкой. Аналогично атрибуту "style" HTML-элемента. Обратите внимание, что, как и атрибут HTML style, эта переменная содержит свойства и значения стилей, а не селектор правила стиля.Парсинг этого стиля может не поддерживаться на некоторых ограниченных платформах. Рекомендуется использовать отдельный CSS-файл вместо этого.
-
getStyle
public final String getStyle()
Строка CSS-стиля, связанная с этой вкладкой.
-
styleProperty
public final StringProperty styleProperty()
Строка CSS-стиля, связанная с этой вкладкой.См. также:
-
isSelected
public final boolean isSelected()
Указывает, является ли эта вкладка текущей выделенной, Для изменения выделенной вкладки используйте
tabPane.getSelectionModel().select()
-
selectedProperty
public final ReadOnlyBooleanProperty selectedProperty()
Текущая выделенная вкладка.См. также:
-
getTabPane
public final TabPane getTabPane()
Ссылка на TabPane, содержащий этот экземпляр вкладки.
-
tabPaneProperty
public final ReadOnlyObjectProperty<TabPane> tabPaneProperty()
TabPane, содержащий эту вкладку.См. также:
-
setText
public final void setText(String value)
Устанавливает текст, отображаемый на вкладке, чтобы пользователь мог различать функции каждой вкладки. Текст всегда отображается
-
getText
public final String getText()
Текст, отображаемый на вкладке.Возвращает:
Текст, отображаемый на вкладке.
-
textProperty
public final StringProperty textProperty()
Текст, отображаемый на вкладке.См. также:
-
setGraphic
public final void setGraphic(Node value)
Устанавливает графическое изображение, отображаемое на вкладке, чтобы пользователь мог различать функции каждой вкладки. По умолчанию изображение не вращается в зависимости от значения TabPane.tabPosition, но его можно настроить на вращение, установив TabPane.rotateGraphic в true.
-
getGraphic
public final Node getGraphic()
Графическое изображение, отображаемое на вкладке.Возвращает:
Графическое изображение, отображаемое на вкладке.
-
graphicProperty
public final ObjectProperty<Node> graphicProperty()
Графическое изображение на вкладке.См. также:
-
setContent
public final void setContent(Node value)
Содержимое, которое необходимо отобразить в области основного TabPane. Содержимое может быть любым узлом, таким как элементы управления пользовательского интерфейса или группы узлов, добавленных в контейнер макета.
-
getContent
public final Node getContent()
Содержимое, связанное с вкладкой.
Возвращает:
Содержимое, связанное с вкладкой.
-
contentProperty
public final ObjectProperty<Node> contentProperty()
Содержимое, связанное с вкладкой.
См. также:
-
setContextMenu
public final void setContextMenu(ContextMenu value)
Указывает контекстное меню, которое должно отображаться при щелчке правой кнопкой мыши по вкладке.
-
getContextMenu
public final ContextMenu getContextMenu()
Контекстное меню, связанное с вкладкой.Возвращает:
Контекстное меню, связанное с вкладкой.
-
contextMenuProperty
public final ObjectProperty<ContextMenu> contextMenuProperty()
Контекстное меню, связанное с вкладкой.См. также:
-
setClosable
public final void setClosable(boolean value)
Устанавливает
true, если вкладка может быть закрыта. Если это установлено вfalse, то независимо от политики закрытия вкладки, пользователь не сможет закрыть эту вкладку. Следовательно, когда это свойствоfalse, кнопка "Закрыть" не будет отображаться на вкладке. По умолчаниюtrue.
-
isClosable
public final boolean isClosable()
Возвращаетtrue, если эта вкладка может быть закрыта.Возвращает:
true, если вкладка может быть закрыта.
-
closableProperty
public final BooleanProperty closableProperty()
Состояние возможности закрытия для этой вкладки.См. также:
-
setOnSelectionChanged
public final void setOnSelectionChanged(EventHandler<Event> value)
Определяет функцию, которая вызывается при изменении выбора на вкладке.
-
getOnSelectionChanged
public final EventHandler<Event> getOnSelectionChanged()
Обработчик событий, связанный с выбором на вкладке.Возвращает:
Обработчик событий, связанный с выбором вкладки.
-
onSelectionChangedProperty
public final ObjectProperty<EventHandler<Event>> onSelectionChangedProperty()
Обработчик событий, связанный с выбором на вкладке.
-
setOnClosed
public final void setOnClosed(EventHandler<Event> value)
Определяет функцию, которая вызывается при закрытии вкладки.
-
getOnClosed
public final EventHandler<Event> getOnClosed()
Обработчик событий, связанный с вкладкой при её закрытии.Возвращает:
Обработчик событий, связанный с вкладкой при её закрытии.
-
onClosedProperty
public final ObjectProperty<EventHandler<Event>> onClosedProperty()
Обработчик событий, связанный с вкладкой при её закрытии.См. также:
-
setTooltip
public final void setTooltip(Tooltip value)
Устанавливает всплывающую подсказку, отображаемую при наведении курсора на вкладку.
-
getTooltip
public final Tooltip getTooltip()
Всплывающая подсказка, связанная с этой вкладкой.Возвращает:
Всплывающая подсказка, связанная с этой вкладкой.
-
tooltipProperty
public final ObjectProperty<Tooltip> tooltipProperty()
Всплывающая подсказка, связанная с этой вкладкой.См. также:
-
setDisable
public final void setDisable(boolean value)
Устанавливает состояние отключения этой вкладки.Значение по умолчанию:
false
Параметры:
value- состояние для установки этой вкладкиС:
JavaFX 2.2
-
isDisable
public final boolean isDisable()
Возвращаетtrue, если эта вкладка отключена.С:
JavaFX 2.2
-
disableProperty
public final BooleanProperty disableProperty()
Устанавливает состояние отключения этой вкладки. Отключенная вкладка больше не интерактивна или не просматривается, но её содержимое остаётся интерактивным. Отключенную вкладку можно выбрать, используяTabPane.getSelectionModel().
-
isDisabled
public final boolean isDisabled()
С:
JavaFX 2.2
-
disabledProperty
public final ReadOnlyBooleanProperty disabledProperty()
Указывает, отключена ли этаTab. Вкладка станет отключенной, еслиdisableустановлено вtrue, либо еслиTabPaneотключена.
-
onCloseRequestProperty
public final ObjectProperty<EventHandler<Event>> onCloseRequestProperty()
Вызывается при внешнем запросе на закрытие этойTab. Установленный обработчик событий может предотвратить закрытие вкладки, обработав полученное событие.С:
JavaFX 8.0
См. также:
-
-
getOnCloseRequest
public EventHandler<Event> getOnCloseRequest()
Возвращает значение свойства onCloseRequest.Описание свойства:
Вызывается, когда происходит внешний запрос на закрытие этой
Tab. Установленный обработчик событий может предотвратить закрытие вкладки, обработав полученное событие.С момента:
JavaFX 8.0
-
setOnCloseRequest
public void setOnCloseRequest(EventHandler<Event> value)
Устанавливает значение свойства onCloseRequest.Описание свойства:
Вызывается, когда происходит внешний запрос на закрытие этой
Tab. Установленный обработчик событий может предотвратить закрытие вкладки, обработав полученное событие.С момента:
JavaFX 8.0
-
getProperties
public final ObservableMap<Object,Object> getProperties()
Возвращает наблюдаемую карту свойств этой вкладки, предназначенную в первую очередь для разработчиков приложений.Возвращает:
наблюдаемую карту свойств этой вкладки, предназначенную в первую очередь для разработчиков приложений
С момента:
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 или null, если такое свойство не было установлено с помощью методаsetUserData(java.lang.Object).Возвращает:
Объект, который был ранее установлен, или null, если свойство не было установлено или было установлено значение null.
С момента:
JavaFX 2.2
-
getStyleClass
public ObservableList<String> getStyleClass()
Список идентификаторов строк, которые могут быть использованы для логического группирования узлов, в частности, для внешнего движка стилей. Эта переменная аналогична атрибуту «class» в HTML-элементе и, как следствие, каждый элемент списка является классом стиля, к которому принадлежит этот узел.Определено в:
getStyleClassв интерфейсеStyleableСм. также:
-
getTypeSelector
public String getTypeSelector()
Тип этойStyleable, который используется в соответствии с селекторами. Это аналогично элементу в HTML. (CSS селектор типа).
-
getStyleableParent
public Styleable getStyleableParent()
Возвращает родительский элемент этого Styleable или null, если родителя нет.Определено в:
getStyleableParentв интерфейсеStyleableВозвращает:
getTabPane()С момента:
JavaFX 8.0
-
getPseudoClassStates
public final ObservableSet<PseudoClass> getPseudoClassStates()
Возвращает состояние псевдокласса этого Styleable. CSS предполагает, что этот набор является только для чтения.Определено в:
getPseudoClassStatesв интерфейсеStyleableС момента:
JavaFX 8.0
-
getCssMetaData
public List<CssMetaData<? extends Styleable,?>> getCssMetaData()
CssMetaData этого Styleable. Может быть возвращен как неизменяемый список.Определено в:
getCssMetaDataв интерфейсеStyleableС момента:
JavaFX 8.0
-
getClassCssMetaData
public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()
Возвращает:
CssMetaData, связанную с этим классом, которая может включать CssMetaData его родительских классов.
С момента:
JavaFX 8.0
-
© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.