Класс Tab
- Все реализованные интерфейсы:
-
Styleable,EventTarget
@DefaultProperty("content") @IDProperty("id") public class Tab extends Object implements EventTarget, Styleable Вкладки размещаются внутри TabPane, где каждая вкладка представляет собой отдельную «страницу».
Вкладки могут содержать любые Node, такие как элементы управления интерфейса пользователя или группы узлов, добавленные в контейнер макета.
При щелчке пользователем на вкладку в TabPane содержимое вкладки становится видимым для пользователя.
- С момента:
- JavaFX 2.0
Краткое описание свойств
| Тип | Свойство | Описание |
|---|---|---|
final BooleanProperty |
closable |
Состояние закрытия для этой вкладки. |
final ObjectProperty<Node> |
content |
Содержимое, связанное с вкладкой. |
final ObjectProperty<ContextMenu> |
contextMenu |
Контекстное меню, связанное с вкладкой. |
final ReadOnlyBooleanProperty |
disabled |
Указывает, отключена ли эта Tab. |
final BooleanProperty |
disable |
Устанавливает состояние отключения для этой вкладки. |
final ObjectProperty<Node> |
graphic |
Графика на вкладке. |
final StringProperty |
id |
Идентификатор этой вкладки. |
final ObjectProperty<EventHandler<Event>> |
onClosed |
Обработчик событий, связанный с вкладкой при закрытии вкладки. |
final ObjectProperty<EventHandler<Event>> |
onCloseRequest |
Вызывается при внешнем запросе на закрытие этой Tab. |
final ObjectProperty<EventHandler<Event>> |
onSelectionChanged |
Обработчик событий, связанный с выбором вкладки. |
final ReadOnlyBooleanProperty |
selected |
Текущая выбранная вкладка. |
final StringProperty |
style |
Строка CSS-стиля, связанная с этой вкладкой. |
final ReadOnlyObjectProperty<TabPane> |
tabPane |
TabPane, содержащий эту вкладку. |
final StringProperty |
text |
Текст, отображаемый на вкладке. |
final ObjectProperty<Tooltip> |
tooltip |
Подсказка, связанная с этой вкладкой. |
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
static final EventType<Event> |
CLOSED_EVENT |
Вызывается при закрытии вкладки пользователем. |
static final EventType<Event> |
SELECTION_CHANGED_EVENT |
Вызывается при выборе или отмене выбора вкладки. |
static final EventType<Event> |
TAB_CLOSE_REQUEST_EVENT |
Вызывается при внешнем запросе на закрытие этой Tab. |
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
Tab() |
Создает вкладку без заголовка. |
Tab |
Создаёт вкладку с текстовым заголовком. |
Tab |
Создаёт вкладку с текстовым заголовком и указанным узлом содержимого. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
final <E extends Event> |
addEventFilter |
Регистрирует фильтр событий для этого целевого объекта. |
final <E extends Event> |
addEventHandler |
Регистрирует обработчик событий для этого целевого объекта. |
EventDispatchChain |
buildEventDispatchChain |
Создаёт цепочку обработки событий для этого целевого объекта. |
final BooleanProperty |
closableProperty() |
Состояние закрытия для этой вкладки. |
final ObjectProperty<Node> |
contentProperty() |
Содержимое, связанное с вкладкой. |
final ObjectProperty<ContextMenu> |
contextMenuProperty() |
Контекстное меню, связанное с вкладкой. |
final ReadOnlyBooleanProperty |
disabledProperty() |
Указывает, отключена ли эта Tab. |
final BooleanProperty |
disableProperty() |
Устанавливает состояние отключения этой вкладки. |
static List<CssMetaData<? extends Styleable, |
getClassCssMetaData() |
Получает CssMetaData, связанное с этим классом, которое может включать в себя CssMetaData его суперклассов. |
final Node |
getContent() |
Содержимое, связанное с вкладкой. |
final ContextMenu |
getContextMenu() |
Контекстное меню, связанное с вкладкой. |
List<CssMetaData<? extends Styleable, |
getCssMetaData() |
CssMetaData этого Styleable. |
final Node |
getGraphic() |
Графика, отображаемая на вкладке. |
final String |
getId() |
Идентификатор этой вкладки. |
final EventHandler<Event> |
getOnClosed() |
Обработчик событий, связанный с вкладкой при её закрытии. |
EventHandler<Event> |
getOnCloseRequest() |
Получает значение свойства onCloseRequest. |
final EventHandler<Event> |
getOnSelectionChanged() |
Обработчик событий, связанный с выбором вкладки. |
final ObservableMap<Object, |
getProperties() |
Возвращает наблюдаемую карту свойств этой вкладки для использования разработчиками приложений. |
final ObservableSet<PseudoClass> |
getPseudoClassStates() |
Возвращает состояние псевдокласса этого Styleable. |
final String |
getStyle() |
Строка CSS-стиля, связанная с этой вкладкой. |
Styleable |
getStyleableParent() |
Возвращает родительский элемент этого Styleable или null, если родительского элемента нет. |
ObservableList<String> |
getStyleClass() |
Список идентификаторов строк, которые могут быть использованы для логической группировки узлов, в частности, для внешнего движка стилей. |
final TabPane |
getTabPane() |
Ссылка на TabPane, содержащий этот экземпляр вкладки. |
final String |
getText() |
Текст, отображаемый на вкладке. |
final Tooltip |
getTooltip() |
Подсказка, связанная с этой вкладкой. |
String |
getTypeSelector() |
Тип этой Styleable, который должен быть использован для сопоставления селекторов. |
Object |
getUserData() |
Возвращает ранее установленное свойство Object или null, если такое свойство не было установлено с помощью метода setUserData(java.lang.Object). |
final ObjectProperty<Node> |
graphicProperty() |
Графика на вкладке. |
boolean |
hasProperties() |
Проверяет, содержит ли эта вкладка свойства. |
final StringProperty |
idProperty() |
Идентификатор этой вкладки. |
final boolean |
isClosable() |
Возвращает true, если эта вкладка открывается. |
final boolean |
isDisable() |
Возвращает true, если эта вкладка отключена. |
final boolean |
isDisabled() |
|
final boolean |
isSelected() |
Представляет, является ли эта вкладка текущей выбранной вкладкой. Для изменения выбранной вкладки используйте tabPane.getSelectionModel().select()
|
final ObjectProperty<EventHandler<Event>> |
onClosedProperty() |
Обработчик событий, связанный с вкладкой при её закрытии. |
final ObjectProperty<EventHandler<Event>> |
onCloseRequestProperty() |
Вызывается при внешнем запросе на закрытие этой Tab. |
final ObjectProperty<EventHandler<Event>> |
onSelectionChangedProperty() |
Обработчик событий, связанный с выбором вкладки. |
final <E extends Event> |
removeEventFilter |
Отменяет ранее зарегистрированный фильтр событий для этого целевого объекта. |
final <E extends Event> |
removeEventHandler |
Отменяет ранее зарегистрированный обработчик событий для этого целевого объекта. |
final ReadOnlyBooleanProperty |
selectedProperty() |
Текущая выбранная вкладка. |
final void |
setClosable |
Устанавливает true, если вкладка открывается. |
final void |
setContent |
Содержимое для отображения в основной области TabPane. |
final void |
setContextMenu |
Указывает контекстное меню для отображения при нажатии правой кнопкой мыши на вкладке. |
final void |
setDisable |
Устанавливает состояние отключения этой вкладки. |
final void |
setGraphic |
Устанавливает графику, отображаемую на вкладке, чтобы пользователь мог отличить функции каждой вкладки. |
final void |
setId |
Устанавливает идентификатор этой вкладки. |
final void |
setOnClosed |
Определяет функцию, которая будет вызвана при закрытии вкладки. |
void |
setOnCloseRequest |
Устанавливает значение свойства onCloseRequest. |
final void |
setOnSelectionChanged |
Определяет функцию, которая будет вызвана при изменении выбора на вкладке. |
final void |
setStyle |
Строковое представление CSS-стиля, связанного с этой вкладкой. |
final void |
setText |
Устанавливает текст, отображаемый на вкладке, чтобы пользователь мог отличить функции каждой вкладки. |
final void |
setTooltip |
Указывает подсказку для отображения при наведении курсора на вкладку. |
void |
setUserData |
Удобный метод для установки одиночного свойства Object, которое можно получить впоследствии. |
final StringProperty |
styleProperty() |
Строка CSS-стиля, связанная с этой вкладкой. |
final ReadOnlyObjectProperty<TabPane> |
tabPaneProperty() |
TabPane, содержащий эту вкладку. |
final StringProperty |
textProperty() |
Текст, отображаемый на вкладке. |
final ObjectProperty<Tooltip> |
tooltipProperty() |
Подсказка, связанная с этой вкладкой. |
Методы, объявленные в классе java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Методы, объявленные в интерфейсе javafx.css.Styleable
getStyleableNode
Подробности свойства
id
public final StringProperty idProperty
- См. также:
style
public final StringProperty styleProperty
- См. также:
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().- Значение по умолчанию:
- false
- С:
- JavaFX 2.2
- См. также:
disabled
public final ReadOnlyBooleanProperty disabledProperty
Tab. Tab станет отключенной, если disable установлено в true либо на самой TabPane, либо если TabPane отключена.- Значение по умолчанию:
- false
- С:
- JavaFX 2.2
- См. также:
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- Заголовок вкладки. -
content- Содержимое вкладки. - С:
- JavaFX 8u40
Подробности методов
setId
public final void setId(String value)
TabPane. Значение по умолчанию - null.- Параметры:
-
value- идентификатор этой вкладки
getId
public final String getId()
- Определено в:
-
getIdв интерфейсеStyleable - Возвращает:
- Идентификатор вкладки.
idProperty
public final StringProperty idProperty()
- Возвращает:
- свойство id этой вкладки
- См. также:
setStyle
public final void setStyle(String value)
Парсинг этого стиля может не поддерживаться на некоторых ограниченных платформах. Рекомендуется использовать отдельный CSS-файл вместо этого.
- Параметры:
-
value- строка стиля
getStyle
public final String getStyle()
- Определено в:
-
getStyleв интерфейсеStyleable - Возвращает:
- Строка CSS-стиля, связанная с этой вкладкой.
styleProperty
public final StringProperty styleProperty()
- Возвращает:
- свойство строки CSS-стиля, связанное с этой вкладкой
- См. также:
isSelected
public final boolean isSelected()
Указывает, является ли эта вкладка текущей выбранной вкладкой. Для изменения выбранной вкладки используйте tabPane.getSelectionModel().select()
- Возвращает:
- true, если выбрана
selectedProperty
public final ReadOnlyBooleanProperty selectedProperty()
- Возвращает:
- выбранную вкладку
- См. также:
getTabPane
public final TabPane getTabPane()
Ссылка на TabPane, содержащий этот экземпляр вкладки.
- Возвращает:
- TabPane
tabPaneProperty
public final ReadOnlyObjectProperty<TabPane> tabPaneProperty()
- Возвращает:
- свойство TabPane
- См. также:
setText
public final void setText(String value)
Устанавливает текст, отображаемый на вкладке, чтобы пользователь мог различать функции каждой вкладки. Текст всегда отображается
- Параметры:
-
value- строка текста
getText
public final String getText()
- Возвращает:
- Текст, отображаемый на вкладке.
textProperty
public final StringProperty textProperty()
- Возвращает:
- свойство текста
- См. также:
setGraphic
public final void setGraphic(Node value)
Устанавливает графический элемент, отображаемый на вкладке, чтобы пользователь мог различать функции каждой вкладки. По умолчанию графический элемент не вращается в зависимости от значения TabPane.tabPosition, но его можно настроить на вращение, установив TabPane.rotateGraphic в true.
- Параметры:
-
value- узел графического элемента
getGraphic
public final Node getGraphic()
- Возвращает:
- Графический элемент, отображаемый на вкладке.
graphicProperty
public final ObjectProperty<Node> graphicProperty()
- Возвращает:
- Графический элемент на вкладке.
- См. также:
setContent
public final void setContent(Node value)
Содержимое, отображаемое в основной области TabPane. Содержимое может быть любым узлом, например, элементами пользовательского интерфейса или группами узлов, добавленных в контейнер макета.
- Параметры:
-
value- узел содержимого
getContent
public final Node getContent()
Содержимое, связанное с вкладкой.
- Возвращает:
- Содержимое, связанное с вкладкой.
contentProperty
public final ObjectProperty<Node> contentProperty()
Содержимое, связанное с вкладкой.
- Возвращает:
- свойство содержимого
- См. также:
setContextMenu
public final void setContextMenu(ContextMenu value)
Указывает контекстное меню, которое отображается, когда пользователь щелкает правой кнопкой мыши по вкладке.
- Параметры:
-
value- контекстное меню
getContextMenu
public final ContextMenu getContextMenu()
- Возвращает:
- Контекстное меню, связанное с вкладкой.
contextMenuProperty
public final ObjectProperty<ContextMenu> contextMenuProperty()
- Возвращает:
- свойство контекстного меню
- См. также:
setClosable
public final void setClosable(boolean value)
Устанавливает true, если вкладка может быть закрыта. Если это установлено в false, то независимо от TabClosingPolicy, пользователь не сможет закрыть эту вкладку. Следовательно, при этом свойстве false, кнопка "Закрыть" не будет отображаться на вкладке. По умолчанию true.
- Параметры:
-
value- значение closable
isClosable
public final boolean isClosable()
true, если эта вкладка может быть закрыта.- Возвращает:
-
true, если вкладка может быть закрыта.
closableProperty
public final BooleanProperty closableProperty()
- Возвращает:
- свойство closable
- См. также:
setOnSelectionChanged
public final void setOnSelectionChanged(EventHandler<Event> value)
- Параметры:
-
value- обработчик события изменения выбора
getOnSelectionChanged
public final EventHandler<Event> getOnSelectionChanged()
- Возвращает:
- Обработчик событий, связанный с выбором вкладки.
onSelectionChangedProperty
public final ObjectProperty<EventHandler<Event>> onSelectionChangedProperty()
- Возвращает:
- свойство обработчика событий изменения выбора
- См. также:
setOnClosed
public final void setOnClosed(EventHandler<Event> value)
- Параметры:
-
value- обработчик события закрытия
getOnClosed
public final EventHandler<Event> getOnClosed()
- Возвращает:
- Обработчик событий, связанный с вкладкой при ее закрытии.
onClosedProperty
public final ObjectProperty<EventHandler<Event>> onClosedProperty()
- Возвращает:
- свойство обработчика событий закрытия
- См. также:
setTooltip
public final void setTooltip(Tooltip value)
Устанавливает всплывающую подсказку, отображаемую при наведении курсора на вкладку.
- Параметры:
-
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, если эта вкладка отключена.- Возвращает:
- true, если эта вкладка отключена
- С:
- JavaFX 2.2
disableProperty
public final BooleanProperty disableProperty()
TabPane.getSelectionModel().- Значение по умолчанию:
- false
- Возвращает:
- свойство disable
- С тех пор:
- JavaFX 2.2
- См. также:
isDisabled
public final boolean isDisabled()
- Возвращает:
- true, если TabPane отключена
- С тех пор:
- JavaFX 2.2
disabledProperty
public final ReadOnlyBooleanProperty disabledProperty()
Tab. Tab станет отключенной, если disable установлено в true либо на самой вкладке, либо если TabPane отключена.- Значение по умолчанию:
- false
- Возвращает:
- свойство disabled
- С тех пор:
- JavaFX 2.2
- См. также:
onCloseRequestProperty
public final ObjectProperty<EventHandler<Event>> onCloseRequestProperty()
Tab. Установленный обработчик событий может предотвратить закрытие вкладки, обработав полученное событие.- Возвращает:
- свойство
onCloseRequest - С тех пор:
- JavaFX 8.0
- См. также:
getOnCloseRequest
public EventHandler<Event> getOnCloseRequest()
onCloseRequest.- Описание свойства:
- Вызывается при внешнем запросе на закрытие этой
Tab. Установленный обработчик событий может предотвратить закрытие вкладки, обработав полученное событие. - Возвращает:
- значение свойства
onCloseRequest - С тех пор:
- JavaFX 8.0
- См. также:
setOnCloseRequest
public void setOnCloseRequest(EventHandler<Event> value)
onCloseRequest.- Описание свойства:
- Вызывается при внешнем запросе на закрытие этой
Tab. Установленный обработчик событий может предотвратить закрытие вкладки, обработав полученное событие. - Параметры:
-
value- значение для свойстваonCloseRequest - С тех пор:
- 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)
getUserData().- Параметры:
-
value- значение, которое нужно сохранить — его можно получить позднее, вызвавgetUserData(). - С тех пор:
- JavaFX 2.2
getUserData
public Object getUserData()
setUserData(java.lang.Object).- Возвращает:
- Объект, который был ранее задан, или null, если свойство не задано или было установлено значение null.
- С тех пор:
- JavaFX 2.2
getStyleClass
public ObservableList<String> getStyleClass()
- Определено в:
-
getStyleClassв интерфейсеStyleable - Возвращает:
- список идентификаторов строк, которые можно использовать для логической группировки узлов, в частности, для внешнего механизма стилей
- См. также:
buildEventDispatchChain
public EventDispatchChain buildEventDispatchChain(EventDispatchChain tail)
EventTargetEventTarget. Этот целевой объект события не добавляется автоматически в цепочку, поэтому, если он хочет обрабатывать события, он должен добавить для себя EventDispatcher в цепочку. В случае, если целевой объект события является частью иерархии, цепочка для него обычно строится из обработчиков событий, собранных от корня иерархии до целевого объекта.
Цепочка обработки событий создаётся путём модификации предоставленной начальной цепочки обработки событий. Возвращаемая цепочка должна содержать начальную цепочку в конце, поэтому обработчики должны быть добавлены в начало начальной цепочки.
Вызывающий метод не должен предполагать, что начальная цепочка останется неизменной, а также что возвращаемое значение будет ссылаться на другую цепочку.
- Определено в:
-
buildEventDispatchChainв интерфейсеEventTarget - Параметры:
-
tail- начальная цепочка для построения - Возвращает:
- результирующая цепочка обработки событий для этого целевого объекта
addEventHandler
public final <E extends Event> void addEventHandler(EventType<E> eventType, EventHandler<? super E> eventHandler)
EventTarget Обработчик вызывается, когда целевой объект получает Event указанного типа во время фазы всплытия доставки событий.
- Определено в:
-
addEventHandlerв интерфейсеEventTarget - Тип параметров:
-
E- класс события обработчика - Параметры:
-
eventType- тип событий, получаемых обработчиком -
eventHandler- обработчик событий
removeEventHandler
public final <E extends Event> void removeEventHandler(EventType<E> eventType, EventHandler<? super E> eventHandler)
EventTarget Поскольку возможно зарегистрировать один экземпляр EventHandler для различных типов событий, вызывающему методу необходимо указать тип события, от которого следует отменить регистрацию обработчика.
- Определено в:
-
removeEventHandlerв интерфейсеEventTarget - Тип параметров:
-
E- класс события обработчика - Параметры:
-
eventType- тип события, от которого следует отменить регистрацию -
eventHandler- обработчик событий
addEventFilter
public final <E extends Event> void addEventFilter(EventType<E> eventType, EventHandler<? super E> eventFilter)
EventTarget Фильтр вызывается, когда целевой объект получает Event указанного типа во время фазы захвата доставки событий.
- Определено в:
-
addEventFilterв интерфейсеEventTarget - Тип параметров:
-
E- класс события фильтра - Параметры:
-
eventType- тип событий, получаемых фильтром -
eventFilter- фильтр событий
removeEventFilter
public final <E extends Event> void removeEventFilter(EventType<E> eventType, EventHandler<? super E> eventFilter)
EventTarget Поскольку для одного экземпляра EventHandler возможно регистрация для разных типов событий, вызывающему методу необходимо указать тип события, для которого нужно удалить фильтр.
- Specified by:
-
removeEventFilterв интерфейсеEventTarget - Type Parameters:
-
E- класс события фильтра - Parameters:
-
eventType- тип события, для которого нужно удалить фильтр -
eventFilter- фильтр событий
getTypeSelector
public String getTypeSelector()
Styleable, используемый в соответствии собора, аналогичный "элементу" в HTML. (CSS Тип селектора).- Specified by:
-
getTypeSelectorв интерфейсеStyleable - Returns:
- "Вкладка"
- Since:
- JavaFX 8.0
getStyleableParent
public Styleable getStyleableParent()
- Specified by:
-
getStyleableParentв интерфейсеStyleable - Returns:
getTabPane()- Since:
- JavaFX 8.0
getPseudoClassStates
public final ObservableSet<PseudoClass> getPseudoClassStates()
- Specified by:
-
getPseudoClassStatesв интерфейсеStyleable - Returns:
- состояние псевдокласса
- Since:
- JavaFX 8.0
getCssMetaData
public List<CssMetaData<? extends Styleable,?>> getCssMetaData()
- Specified by:
-
getCssMetaDataв интерфейсеStyleable - Returns:
- CssMetaData
- Since:
- JavaFX 8.0
getClassCssMetaData
public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()
CssMetaData, связанный с этим классом, который может включать CssMetaData его суперклассов.- Returns:
CssMetaData- Since:
- 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.