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