Spec-Zone.ru › OpenJavaFX 17

Класс Вкладка

java.lang.Object
javafx.scene.control.Tab
Все реализуемые интерфейсы:
Styleable, EventTarget
@DefaultProperty("content")
@IDProperty("id")
public class Tab
extends Object
implements EventTarget, Styleable

Вкладки размещаются внутри TabPane, где каждая вкладка представляет собой отдельную «страницу».

Вкладки могут содержать любые Node, такие как элементы управления пользовательского интерфейса или группы узлов, добавленных в контейнер макета.

Когда пользователь щелкает по вкладке в TabPane, содержимое вкладки становится видимым для пользователя.

С:
JavaFX 2.0

Краткое описание свойств

Свойства
Тип Свойство Описание
BooleanProperty closable
Состояние возможности закрытия этой вкладки.
ObjectProperty<Node> content
Содержимое, связанное с вкладкой.
ObjectProperty<ContextMenu> contextMenu
Контекстное меню, связанное с вкладкой.
ReadOnlyBooleanProperty disabled
Указывает, отключена ли эта Tab.
BooleanProperty disable
Устанавливает состояние отключения этой вкладки.
ObjectProperty<Node> graphic
Графика на вкладке.
StringProperty id
Идентификатор этой вкладки.
ObjectProperty<EventHandler<Event>> onClosed
Обработчик событий, связанный с вкладкой при ее закрытии.
ObjectProperty<EventHandler<Event>> onCloseRequest
Вызывается при внешнем запросе на закрытие этой Tab.
ObjectProperty<EventHandler<Event>> onSelectionChanged
Обработчик событий, связанный с выбором вкладки.
ReadOnlyBooleanProperty selected
Текущая выбранная вкладка.
StringProperty style
Строка CSS-стиля, связанная с этой вкладкой.
ReadOnlyObjectProperty<TabPane> tabPane
TabPane, содержащий эту вкладку.
StringProperty text
Текст, отображаемый на вкладке.
ObjectProperty<Tooltip> tooltip
Подсказка, связанная с этой вкладкой.

Краткое описание полей

Поля
Модификатор и тип Поле Описание
static EventType<Event> CLOSED_EVENT
Вызывается при закрытии этой вкладки пользователем.
static EventType<Event> SELECTION_CHANGED_EVENT
Вызывается при выборе или отмене выбора вкладки.
static EventType<Event> TAB_CLOSE_REQUEST_EVENT
Вызывается при внешнем запросе на закрытие этой Tab.

Краткое описание конструкторов

Конструкторы
Конструктор Описание
Tab()
Создаёт вкладку без заголовка.
Tab​(String text)
Создаёт вкладку с текстовым заголовком.
Tab​(String text, Node content)
Создаёт вкладку с текстовым заголовком и указанным узлом содержимого.

Краткое описание методов

Модификатор и тип Метод Описание
BooleanProperty closableProperty()
Состояние закрытия для этой вкладки.
ObjectProperty<Node> contentProperty()
Содержимое, связанное с вкладкой.
ObjectProperty<ContextMenu> contextMenuProperty()
Контекстное меню, связанное с вкладкой.
ReadOnlyBooleanProperty disabledProperty()
Указывает, отключена ли эта Tab.
BooleanProperty disableProperty()
Устанавливает состояние отключения для этой вкладки.
static List<CssMetaData<? extends Styleable,​?>> getClassCssMetaData()
Node getContent()
Содержимое, связанное с вкладкой.
ContextMenu getContextMenu()
Контекстное меню, связанное с вкладкой.
List<CssMetaData<? extends Styleable,​?>> getCssMetaData()
CssMetaData для этого Styleable.
Node getGraphic()
Изображение, отображаемое на вкладке.
String getId()
Идентификатор этой вкладки.
EventHandler<Event> getOnClosed()
Обработчик событий, связанный с вкладкой при ее закрытии.
EventHandler<Event> getOnCloseRequest()
Получает значение свойства onCloseRequest.
EventHandler<Event> getOnSelectionChanged()
Обработчик событий, связанный с выбором вкладки.
ObservableMap<Object,​Object> getProperties()
Возвращает наблюдаемую карту свойств этой вкладки, предназначенную в первую очередь для разработчиков приложений.
ObservableSet<PseudoClass> getPseudoClassStates()
Возвращает состояние псевдокласса этого Styleable.
String getStyle()
Строка CSS-стиля, связанная с этой вкладкой.
Styleable getStyleableParent()
Возвращает родителя этого Styleable или null, если родителя нет.
ObservableList<String> getStyleClass()
Список строковых идентификаторов, которые могут использоваться для логической группировки узлов, в частности, для внешнего движка стилей.
TabPane getTabPane()
Ссылка на TabPane, содержащий этот экземпляр вкладки.
String getText()
Текст, отображаемый на вкладке.
Tooltip getTooltip()
Подсказка, связанная с этой вкладкой.
String getTypeSelector()
Тип этой Styleable, используемый для сопоставления с селекторами.
Object getUserData()
Возвращает ранее установленное свойство объекта или null, если такое свойство не было установлено с помощью метода setUserData(java.lang.Object).
ObjectProperty<Node> graphicProperty()
Изображение на вкладке.
boolean hasProperties()
Проверяет, имеет ли эта вкладка свойства.
StringProperty idProperty()
Идентификатор этой вкладки.
boolean isClosable()
Возвращает значение true, если эта вкладка может быть закрыта.
boolean isDisable()
Возвращает значение true, если эта вкладка отключена.
boolean isDisabled()
Возвращает true, если свойство Tab disable установлено в true или если вкладка отключена.
boolean isSelected()
Представляет, является ли эта вкладка текущей выбранной вкладкой. Для изменения выбранной вкладки используйте tabPane.getSelectionModel().select()
ObjectProperty<EventHandler<Event>> onClosedProperty()
Обработчик событий, связанный с вкладкой при ее закрытии.
ObjectProperty<EventHandler<Event>> onCloseRequestProperty()
Вызывается при внешнем запросе на закрытие этой Tab.
ObjectProperty<EventHandler<Event>> onSelectionChangedProperty()
Обработчик событий, связанный с выбором вкладки.
ReadOnlyBooleanProperty selectedProperty()
Текущая выбранная вкладка.
void setClosable​(boolean value)
Устанавливает значение true, если вкладка может быть закрыта.
void setContent​(Node value)
Содержимое, отображаемое в области основного TabPane.
void setContextMenu​(ContextMenu value)
Указывает контекстное меню, которое отображается при правом щелчке на вкладке.
void setDisable​(boolean value)
Устанавливает состояние отключения для этой вкладки.
void setGraphic​(Node value)
Устанавливает изображение, отображаемое на вкладке, чтобы пользователь мог отличить функцию каждой вкладки.
void setId​(String value)
Устанавливает идентификатор этой вкладки.
void setOnClosed​(EventHandler<Event> value)
Определяет функцию, которая будет вызвана при закрытии вкладки.
void setOnCloseRequest​(EventHandler<Event> value)
Устанавливает значение свойства onCloseRequest.
void setOnSelectionChanged​(EventHandler<Event> value)
Определяет функцию, вызываемую при изменении выбора на вкладке.
void setStyle​(String value)
Строковое представление CSS-стиля, связанного с этой вкладкой.
void setText​(String value)
Устанавливает текст, отображаемый на вкладке, чтобы пользователь мог отличить функцию каждой вкладки.
void setTooltip​(Tooltip value)
Указывает подсказку, отображаемую при наведении курсора на вкладку.
void setUserData​(Object value)
Удобный метод для установки свойства одиночного объекта, которое может быть получено позднее.
StringProperty styleProperty()
Строка CSS-стиля, связанная с этой вкладкой.
ReadOnlyObjectProperty<TabPane> tabPaneProperty()
Панель вкладок, содержащая эту вкладку.
StringProperty textProperty()
Текст, отображаемый на вкладке.
ObjectProperty<Tooltip> tooltipProperty()
Подсказка, связанная с этой вкладкой.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Методы, объявленные в интерфейсе javafx.event.EventTarget

buildEventDispatchChain

Методы, объявленные в интерфейсе javafx.css.Styleable

getStyleableNode

Подробности свойства

id

public final StringProperty idProperty
Идентификатор этой вкладки.
См. также:
getId(), setId(String)

style

public final StringProperty styleProperty
Строка CSS-стиля, связанная с этой вкладкой.
См. также:
getStyle(), setStyle(String)

selected

public final ReadOnlyBooleanProperty selectedProperty
Текущая выбранная вкладка.
См. также:
isSelected()

tabPane

public final ReadOnlyObjectProperty<TabPane> tabPaneProperty
Панель вкладок, содержащая эту вкладку.
См. также:
getTabPane()

text

public final StringProperty textProperty
Текст, отображаемый на вкладке.
См. также:
getText(), setText(String)

graphic

public final ObjectProperty<Node> graphicProperty
Изображение на вкладке.
См. также:
getGraphic(), setGraphic(Node)

content

public final ObjectProperty<Node> contentProperty

Контент, связанный с вкладкой.

См. также:
getContent(), setContent(Node)

contextMenu

public final ObjectProperty<ContextMenu> contextMenuProperty
Контекстное меню, связанное с вкладкой.
См. также:
getContextMenu(), setContextMenu(ContextMenu)

closable

public final BooleanProperty closableProperty
Состояние закрытия этой вкладки.
См. также:
isClosable(), setClosable(boolean)

onSelectionChanged

public final ObjectProperty<EventHandler<Event>> onSelectionChangedProperty
Обработчик событий, связанных с выбором вкладки.
См. также:
getOnSelectionChanged(), setOnSelectionChanged(EventHandler)

onClosed

public final ObjectProperty<EventHandler<Event>> onClosedProperty
Обработчик событий, связанных с закрытием вкладки.
См. также:
getOnClosed(), setOnClosed(EventHandler)

tooltip

public final ObjectProperty<Tooltip> tooltipProperty
Подсказка, связанная с этой вкладкой.
См. также:
getTooltip(), setTooltip(Tooltip)

disable

public final BooleanProperty disableProperty
Устанавливает состояние отключения этой вкладки. Отключенная вкладка больше не взаимодействует или не доступна для навигации, но ее содержимое остается интерактивным. Отключенную вкладку можно выбрать, используя TabPane.getSelectionModel().
Значение по умолчанию:
false
С:
JavaFX 2.2
См. также:
isDisable(), setDisable(boolean)

disabled

public final ReadOnlyBooleanProperty disabledProperty
Указывает, отключена ли эта Tab. Tab станет отключенной, если disable установлено в true, либо если TabPane отключена.
Значение по умолчанию:
false
С:
JavaFX 2.2
См. также:
isDisabled()

onCloseRequest

public final ObjectProperty<EventHandler<Event>> onCloseRequestProperty
Вызывается при внешнем запросе на закрытие этой Tab. Установленный обработчик событий может предотвратить закрытие вкладки, потребляя полученное событие.
С:
JavaFX 8.0
См. также:
getOnCloseRequest(), setOnCloseRequest(EventHandler)

Подробности поля

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()
Идентификатор этой вкладки.
См. также:
getId(), setId(String)

setStyle

public final void setStyle(String value)
Строковое представление CSS-стиля, связанного с этой вкладкой. Это аналогично атрибуту "style" HTML-элемента. Обратите внимание, что, как и атрибут HTML style, эта переменная содержит свойства и значения стилей, а не часть правила стиля.
Параметры:
value - строка стиля

getStyle

public final String getStyle()
Строка CSS-стиля, связанная с этой вкладкой.
Определено в:
getStyle в интерфейсе Styleable
Возвращает:
Строка CSS-стиля, связанная с этой вкладкой.

styleProperty

public final StringProperty styleProperty()
Строка CSS-стиля, связанная с этой вкладкой.
См. также:
getStyle(), setStyle(String)

isSelected

public final boolean isSelected()

Представляет, является ли эта вкладка текущей выбранной вкладкой, чтобы изменить выбранную вкладку, используйте tabPane.getSelectionModel().select()

Возвращает:
true, если выбрано

selectedProperty

public final ReadOnlyBooleanProperty selectedProperty()
Текущая выбранная вкладка.
См. также:
isSelected()

getTabPane

public final TabPane getTabPane()

Ссылка на TabPane, содержащий этот экземпляр вкладки.

Возвращает:
TabPane

tabPaneProperty

public final ReadOnlyObjectProperty<TabPane> tabPaneProperty()
Панель вкладок, содержащая эту вкладку.
См. также:
getTabPane()

setText

public final void setText(String value)

Устанавливает текст, который будет отображаться на вкладке, чтобы пользователь мог различать функцию каждой вкладки. Текст всегда виден

Параметры:
value - строка текста

getText

public final String getText()
Текст, отображаемый во вкладке.
Возвращает:
Текст, отображаемый во вкладке.

textProperty

public final StringProperty textProperty()
Текст, отображаемый во вкладке.
См. также:
getText(), setText(String)

setGraphic

public final void setGraphic(Node value)

Устанавливает графическое изображение для отображения во вкладке, чтобы пользователь мог различать функции каждой вкладки. По умолчанию графическое изображение не вращается в зависимости от значения TabPane.tabPosition, но его можно настроить на вращение, установив TabPane.rotateGraphic в true.

Параметры:
value - узел графического изображения

getGraphic

public final Node getGraphic()
Графическое изображение, отображаемое во вкладке.
Возвращает:
Графическое изображение, отображаемое во вкладке.

graphicProperty

public final ObjectProperty<Node> graphicProperty()
Графическое изображение во вкладке.
См. также:
getGraphic(), setGraphic(Node)

setContent

public final void setContent(Node value)

Содержимое для отображения в области основного TabPane. Содержимое может быть любым узлом, таким как элементы управления пользовательского интерфейса или группы узлов, добавленных в контейнер макета.

Параметры:
value - узел содержимого

getContent

public final Node getContent()

Содержимое, связанное с вкладкой.

Возвращает:
Содержимое, связанное с вкладкой.

contentProperty

public final ObjectProperty<Node> contentProperty()

Содержимое, связанное с вкладкой.

См. также:
getContent(), setContent(Node)

setContextMenu

public final void setContextMenu(ContextMenu value)

Устанавливает контекстное меню, которое отображается при щелчке правой кнопкой мыши на вкладке.

Параметры:
value - контекстное меню

getContextMenu

public final ContextMenu getContextMenu()
Контекстное меню, связанное с вкладкой.
Возвращает:
Контекстное меню, связанное с вкладкой.

contextMenuProperty

public final ObjectProperty<ContextMenu> contextMenuProperty()
Контекстное меню, связанное с вкладкой.
См. также:
getContextMenu(), setContextMenu(ContextMenu)

setClosable

public final void setClosable(boolean value)

Устанавливает true, если вкладка может быть закрыта. Если это значение установлено в false, то независимо от политики закрытия вкладок, пользователь не сможет закрыть эту вкладку. Поэтому, когда это свойство установлено в false, кнопка «Закрыть» не будет отображаться на вкладке. По умолчанию значение true.

Параметры:
value - значение closable

isClosable

public final boolean isClosable()
Возвращает true, если эта вкладка может быть закрыта.
Возвращает:
true, если вкладка может быть закрыта.

closableProperty

public final BooleanProperty closableProperty()
Состояние closable для этой вкладки.
См. также:
isClosable(), setClosable(boolean)

setOnSelectionChanged

public final void setOnSelectionChanged(EventHandler<Event> value)
Определяет функцию, которая вызывается при изменении выбора на вкладке.
Параметры:
value - обработчик событий изменения выбора

getOnSelectionChanged

public final EventHandler<Event> getOnSelectionChanged()
Обработчик событий, связанный с выбором на вкладке.
Возвращает:
Обработчик событий, связанный с выбором вкладки.

onSelectionChangedProperty

public final ObjectProperty<EventHandler<Event>> onSelectionChangedProperty()
Обработчик событий, связанный с выбором на вкладке.
См. также:
getOnSelectionChanged(), setOnSelectionChanged(EventHandler)

setOnClosed

public final void setOnClosed(EventHandler<Event> value)
Определяет функцию, которая вызывается при закрытии вкладки.
Параметры:
value - обработчик событий закрытия

getOnClosed

public final EventHandler<Event> getOnClosed()
Обработчик событий, связанный с вкладкой при закрытии вкладки.
Возвращает:
Обработчик событий, связанный с вкладкой при закрытии вкладки.

onClosedProperty

public final ObjectProperty<EventHandler<Event>> onClosedProperty()
Обработчик событий, связанный с вкладкой при закрытии вкладки.
См. также:
getOnClosed(), setOnClosed(EventHandler)

setTooltip

public final void setTooltip(Tooltip value)

Устанавливает всплывающую подсказку, которая отображается при наведении курсора на вкладку.

Параметры:
value - значение всплывающей подсказки

getTooltip

public final Tooltip getTooltip()
Всплывающая подсказка, связанная с этой вкладкой.
Возвращает:
Всплывающая подсказка, связанная с этой вкладкой.

tooltipProperty

public final ObjectProperty<Tooltip> tooltipProperty()
Всплывающая подсказка, связанная с этой вкладкой.
См. также:
getTooltip(), setTooltip(Tooltip)

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
См. также:
isDisable(), setDisable(boolean)

isDisabled

public final boolean isDisabled()
Возвращает true, когда свойство Tab disable установлено в true или если TabPane отключена.
Возвращает:
true, если TabPane отключена
С:
JavaFX 2.2

disabledProperty

public final ReadOnlyBooleanProperty disabledProperty()
Указывает, отключена ли эта Tab или нет. Tab станет отключенной, если disable установлено в true либо на самой вкладке, либо если TabPane отключена.
Значение по умолчанию:
false
С:
JavaFX 2.2
См. также:
isDisabled()

onCloseRequestProperty

public final ObjectProperty<EventHandler<Event>> onCloseRequestProperty()
Вызывается при внешнем запросе на закрытие этой Tab. Установленный обработчик событий может предотвратить закрытие вкладки, обработав полученное событие.
С:
JavaFX 8.0
См. также:
getOnCloseRequest(), setOnCloseRequest(EventHandler)

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()
Список идентификаторов String, которые могут использоваться для логического группирования узлов, в частности для внешнего механизма стилей. Эта переменная аналогична атрибуту «class» в HTML-элементе и, как следствие, каждый элемент списка является классом стиля, к которому принадлежит этот узел.
Определено в:
getStyleClass в интерфейсе Styleable
Возвращает:
список идентификаторов String, которые могут использоваться для логического группирования узлов, в частности для внешнего механизма стилей
См. также:
CSS3 классы селекторов

getTypeSelector

public String getTypeSelector()
Тип этого Styleable, который будет использоваться в соответствии с селектором. Это аналогично «элементу» в HTML. (CSS селектор типа).
Определено в:
getTypeSelector в интерфейсе Styleable
Возвращает:
"Вкладка"
С тех пор:
JavaFX 8.0

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
Возвращает:
CssMetaData
С тех пор:
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.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API