Класс Tooltip
- Все реализованные интерфейсы:
-
Styleable,EventTarget,Skinnable
@IDProperty("id")
public class Tooltip
extends PopupControl text изменяется, чтобы отобразить обычный текст пользователю. Однако подсказка может отображать в себе произвольное дерево сцены узлов — это делается путём создания дерева сцены и его установки в свойстве подсказки graphic. Вы используете следующий подход для установки подсказки на любой узел:
Rectangle rect = new Rectangle(0, 0, 100, 100);
Tooltip t = new Tooltip("A Square");
Tooltip.install(rect, t); Эта подсказка затем будет участвовать в стандартной семантике подсказок (т.е. появляться при наведении, и т.д.). Обратите внимание, что подсказку не нужно удалять: она будет удалена сборщиком мусора, когда она больше нигде не будет ссылаться. Однако удалить подсказку можно вручную. Одна подсказка может быть установлена на нескольких целевых узлах или нескольких элементах управления.
Поскольку большинство подсказок отображаются на элементах управления пользовательского интерфейса, для всех элементов управления имеется специальный API, чтобы установка подсказки была менее громоздкой. Приведённый ниже пример показывает, как создать подсказку для элемента управления кнопкой:
Button button = new Button("Hover Over Me");
button.setTooltip(new Tooltip("Tooltip for Button")); - С момента:
- JavaFX 2.0
Краткое описание свойств
| Тип | Свойство | Описание |
|---|---|---|
ReadOnlyBooleanProperty | activated | Как правило, подсказка «активируется», когда курсор мыши перемещается над элементом управления. |
ObjectProperty<ContentDisplay> | contentDisplay | Устанавливает позиционирование графики относительно текста. |
ObjectProperty<Font> | font | Шрифт по умолчанию для использования текста в подсказке. |
ObjectProperty<Node> | graphic | Необязательный значок для подсказки. |
DoubleProperty | graphicTextGap | Расстояние между графикой и текстом |
ObjectProperty<Duration> | hideDelay | Продолжительность отображения подсказки после того, как курсор мыши ушел с узла. |
ObjectProperty<Duration> | showDelay | Задержка между входом курсора мыши в наведённый узел и отображением связанной подсказки пользователю. |
ObjectProperty<Duration> | showDuration | Продолжительность отображения подсказки до её исчезновения для пользователя. |
ObjectProperty<TextAlignment> | textAlignment | Устанавливает поведение строк текста при многострочном тексте. |
ObjectProperty<OverrunStyle> | textOverrun | Определяет поведение в случае, если текст Tooltip превышает доступное пространство для отображения текста. |
StringProperty | text | Текст, отображаемый в подсказке. |
BooleanProperty | wrapText | Если фрагмент текста превышает ширину подсказки, то эта переменная указывает, должен ли текст переноситься на другую строку. |
Свойства, объявленные в классе javafx.scene.control.PopupControl
id, maxHeight, maxWidth, minHeight, minWidth, prefHeight, prefWidth, skin, style
Свойства, объявленные в классе javafx.stage.PopupWindow
anchorLocation, anchorX, anchorY, autoFix, autoHide, consumeAutoHidingEvents, hideOnEscape, onAutoHide, ownerNode, ownerWindow
Свойства, объявленные в классе javafx.stage.Window
eventDispatcher, focused, forceIntegerRenderScale, height, onCloseRequest, onHidden, onHiding, onShowing, onShown, opacity, outputScaleX, outputScaleY, renderScaleX, renderScaleY, scene, showing, width, x, y
Краткое описание вложенных классов
Вложенные классы/интерфейсы, объявленные в классе javafx.stage.PopupWindow
PopupWindow.AnchorLocation
Краткое описание полей
Поля, объявленные в классе javafx.scene.control.PopupControl
bridge, USE_COMPUTED_SIZE, USE_PREF_SIZE
Краткое описание конструкторов
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
ReadOnlyBooleanProperty | activatedProperty() | Обычно всплывающая подсказка «активируется», когда курсор мыши перемещается над элементом управления. |
ObjectProperty<ContentDisplay> | contentDisplayProperty() | Указывает расположение графического элемента относительно текста. |
ObjectProperty<Font> | fontProperty() | Шрифт по умолчанию для текста всплывающей подсказки. |
static List<CssMetaData<? extends Styleable,?>> | getClassCssMetaData() | |
ContentDisplay | getContentDisplay() | Возвращает значение свойства contentDisplay. |
List<CssMetaData<? extends Styleable,?>> | getCssMetaData() | CssMetaData этого стилизуемого элемента. |
Font | getFont() | Возвращает значение свойства font. |
Node | getGraphic() | Возвращает значение свойства graphic. |
double | getGraphicTextGap() | Возвращает значение свойства graphicTextGap. |
Duration | getHideDelay() | Возвращает значение свойства hideDelay. |
Duration | getShowDelay() | Возвращает значение свойства showDelay. |
Duration | getShowDuration() | Возвращает значение свойства showDuration. |
String | getText() | Возвращает значение свойства text. |
TextAlignment | getTextAlignment() | Возвращает значение свойства textAlignment. |
OverrunStyle | getTextOverrun() | Возвращает значение свойства textOverrun. |
ObjectProperty<Node> | graphicProperty() | Необязательный значок для всплывающей подсказки. |
DoubleProperty | graphicTextGapProperty() | Расстояние между графическим элементом и текстом |
ObjectProperty<Duration> | hideDelayProperty() | Время отображения всплывающей подсказки после того, как курсор мыши покинул узел. |
static void | install(Node node,
Tooltip t) | |
boolean | isActivated() | Возвращает значение свойства activated. |
boolean | isWrapText() | Возвращает значение свойства wrapText. |
void | setContentDisplay(ContentDisplay value) | Устанавливает значение свойства contentDisplay. |
void | setFont(Font value) | Устанавливает значение свойства font. |
void | setGraphic(Node value) | Устанавливает значение свойства graphic. |
void | setGraphicTextGap(double value) | Устанавливает значение свойства graphicTextGap. |
void | setHideDelay(Duration hideDelay) | Устанавливает значение свойства hideDelay. |
void | setShowDelay(Duration showDelay) | Устанавливает значение свойства showDelay. |
void | setShowDuration(Duration showDuration) | Устанавливает значение свойства showDuration. |
void | setText(String value) | Устанавливает значение свойства text. |
void | setTextAlignment(TextAlignment value) | Устанавливает значение свойства textAlignment. |
void | setTextOverrun(OverrunStyle value) | Устанавливает значение свойства textOverrun. |
void | setWrapText(boolean value) | Устанавливает значение свойства wrapText. |
ObjectProperty<Duration> | showDelayProperty() | Задержка между тем, как курсор мыши входит в выделенный узел, и отображением связанной всплывающей подсказки пользователю. |
ObjectProperty<Duration> | showDurationProperty() | Время, в течение которого всплывающая подсказка должна оставаться видимой для пользователя, прежде чем исчезнуть. |
ObjectProperty<TextAlignment> | textAlignmentProperty() | Определяет поведение для строк текста при многострочном тексте. |
ObjectProperty<OverrunStyle> | textOverrunProperty() | Определяет поведение в случае, если текст Tooltip превышает доступное пространство для отображения текста. |
StringProperty | textProperty() | Текст, который следует отобразить во всплывающей подсказке. |
static void | uninstall(Node node,
Tooltip t) | |
BooleanProperty | wrapTextProperty() | Если строка текста превышает ширину всплывающей подсказки, то эта переменная указывает, следует ли переносить текст на новую строку. |
Методы, объявленные в классе javafx.scene.control.PopupControl
createDefaultSkin, getId, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getPrefHeight, getPrefWidth, getPseudoClassStates, getStyle, getStyleableParent, getStyleClass, getTypeSelector, idProperty, maxHeight, maxHeightProperty, maxWidth, maxWidthProperty, minHeight, minHeightProperty, minWidth, minWidthProperty, prefHeight, prefHeightProperty, prefWidth, prefWidthProperty, pseudoClassStateChanged, setId, setMaxHeight, setMaxSize, setMaxWidth, setMinHeight, setMinSize, setMinWidth, setPrefHeight, setPrefSize, setPrefWidth, setStyle, skinProperty, styleProperty
Методы, объявленные в классе javafx.stage.PopupWindow
anchorLocationProperty, anchorXProperty, anchorYProperty, autoFixProperty, autoHideProperty, consumeAutoHidingEventsProperty, getAnchorLocation, getAnchorX, getAnchorY, getConsumeAutoHidingEvents, getOnAutoHide, getOwnerNode, getOwnerWindow, hide, hideOnEscapeProperty, isAutoFix, isAutoHide, isHideOnEscape, onAutoHideProperty, ownerNodeProperty, ownerWindowProperty, setAnchorLocation, setAnchorX, setAnchorY, setAutoFix, setAutoHide, setConsumeAutoHidingEvents, setHideOnEscape, setOnAutoHide, setScene, show, show, show
Методы, объявленные в классе javafx.stage.Window
addEventFilter, addEventHandler, buildEventDispatchChain, centerOnScreen, eventDispatcherProperty, fireEvent, focusedProperty, forceIntegerRenderScaleProperty, getEventDispatcher, getHeight, getOnCloseRequest, getOnHidden, getOnHiding, getOnShowing, getOnShown, getOpacity, getOutputScaleX, getOutputScaleY, getProperties, getRenderScaleX, getRenderScaleY, getScene, getUserData, getWidth, getWindows, getX, getY, hasProperties, heightProperty, isFocused, isForceIntegerRenderScale, isShowing, onCloseRequestProperty, onHiddenProperty, onHidingProperty, onShowingProperty, onShownProperty, opacityProperty, outputScaleXProperty, outputScaleYProperty, removeEventFilter, removeEventHandler, renderScaleXProperty, renderScaleYProperty, requestFocus, sceneProperty, setEventDispatcher, setEventHandler, setForceIntegerRenderScale, setHeight, setOnCloseRequest, setOnHidden, setOnHiding, setOnShowing, setOnShown, setOpacity, setRenderScaleX, setRenderScaleY, setUserData, setWidth, setX, setY, show, showingProperty, sizeToScene, widthProperty, xProperty, yProperty
Методы, объявленные в классе java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Методы, объявленные в интерфейсе javafx.css.Styleable
getStyleableNode
Подробности свойства
текст
public final StringProperty textProperty
- См. также:
-
getText(),setText(String)
выравниваниеТекста
public final ObjectProperty<TextAlignment> textAlignmentProperty
contentDisplay, которое влияет на графику и текст, данное свойство влияет только на несколько строк текста относительно границ текста.- См. также:
-
getTextAlignment(),setTextAlignment(TextAlignment)
textOverrun
public final ObjectProperty<OverrunStyle> textOverrunProperty
Tooltip превышает доступное пространство для отображения текста.- См. также:
-
getTextOverrun(),setTextOverrun(OverrunStyle)
переносТекста
public final BooleanProperty wrapTextProperty
- См. также:
-
isWrapText(),setWrapText(boolean)
шрифт
public final ObjectProperty<Font> fontProperty
- См. также:
-
getFont(),setFont(Font)
задержкаПоказа
public final ObjectProperty<Duration> showDelayProperty
- Значение по умолчанию:
- 1000 мс
- С версии:
- 9
- См. также:
-
getShowDelay(),setShowDelay(Duration)
продолжительностьПоказа
public final ObjectProperty<Duration> showDurationProperty
hideDelayProperty(), даже если оставшееся время showDuration меньше, чем задержка hideDelay. Значение по умолчанию — 5000 мс.- Значение по умолчанию:
- 5000 мс
- С версии:
- 9
- См. также:
-
getShowDuration(),setShowDuration(Duration)
задержкаСкрытия
public final ObjectProperty<Duration> hideDelayProperty
- Значение по умолчанию:
- 200 мс
- С версии:
- 9
- См. также:
-
getHideDelay(),setHideDelay(Duration)
графика
public final ObjectProperty<Node> graphicProperty
content display. Узел, указанный для этой переменной, не может появляться в другом месте в дереве сцены, иначе будет выброшено IllegalArgumentException. Дополнительные сведения см. в описании класса Node.- См. также:
-
getGraphic(),setGraphic(Node)
отображениеСодержимого
public final ObjectProperty<ContentDisplay> contentDisplayProperty
- См. также:
-
getContentDisplay(),setContentDisplay(ContentDisplay)
отступГрафикаТекст
public final DoubleProperty graphicTextGapProperty
- См. также:
-
getGraphicTextGap(),setGraphicTextGap(double)
активировано
public final ReadOnlyBooleanProperty activatedProperty
- См. также:
isActivated()
Подробности конструктора
Tooltip
public Tooltip()
Tooltip
public Tooltip(String text)
- Параметры:
-
text- Строка текста для всплывающей подсказки.
Подробности метода
install
public static void install(Node node, Tooltip t)
Tooltip с заданным узлом Node. Затем всплывающая подсказка может вести себя аналогично, когда она установлена на любой элемент управления Control. Одна всплывающая подсказка может быть связана с несколькими узлами.- Параметры:
-
node- узел -
t- всплывающая подсказка - См. также:
Tooltip
uninstall
public static void uninstall(Node node, Tooltip t)
Tooltip с указанным узлом Node. В результате наведение на узел больше не приведет к отображению всплывающей подсказки.- Параметры:
-
node- узел -
t- всплывающая подсказка - См. также:
Tooltip
textProperty
public final StringProperty textProperty()
- См. также:
-
getText(),setText(String)
setText
public final void setText(String value)
- Описание свойства:
- Текст, отображаемый во всплывающей подсказке. Если текст задан как null, будет отображена пустая строка, несмотря на то, что значение равно null.
getText
public final String getText()
- Описание свойства:
- Текст, отображаемый во всплывающей подсказке. Если текст задан как null, будет отображена пустая строка, несмотря на то, что значение равно null.
textAlignmentProperty
public final ObjectProperty<TextAlignment> textAlignmentProperty()
contentDisplay, которое влияет на графику и текст, данное свойство влияет только на несколько строк текста относительно границ текста.- См. также:
-
getTextAlignment(),setTextAlignment(TextAlignment)
setTextAlignment
public final void setTextAlignment(TextAlignment value)
- Описание свойства:
- Определяет поведение строк текста при многострочном тексте. В отличие от
contentDisplay, которое влияет на графику и текст, данное свойство влияет только на несколько строк текста относительно границ текста.
getTextAlignment
public final TextAlignment getTextAlignment()
- Описание свойства:
- Определяет поведение строк текста при многострочном тексте. В отличие от
contentDisplay, которое влияет на графику и текст, данное свойство влияет только на несколько строк текста относительно границ текста.
textOverrunСвойство
public final ObjectProperty<OverrunStyle> textOverrunProperty()
Tooltip выходит за пределы доступного места для отображения текста.- См. также:
-
getTextOverrun(),setTextOverrun(OverrunStyle)
setTextOverrun
public final void setTextOverrun(OverrunStyle value)
- Описание свойства:
- Указывает поведение, которое следует использовать, если текст
Tooltipвыходит за пределы доступного места для отображения текста.
getTextOverrun
public final OverrunStyle getTextOverrun()
- Описание свойства:
- Указывает поведение, которое следует использовать, если текст
Tooltipвыходит за пределы доступного места для отображения текста.
wrapTextСвойство
public final BooleanProperty wrapTextProperty()
- См. также:
-
isWrapText(),setWrapText(boolean)
setWrapText
public final void setWrapText(boolean value)
- Описание свойства:
- Если строка текста выходит за пределы ширины подсказки, эта переменная указывает, нужно ли переносить текст на новую строку.
isWrapText
public final boolean isWrapText()
- Описание свойства:
- Если строка текста выходит за пределы ширины подсказки, эта переменная указывает, нужно ли переносить текст на новую строку.
fontСвойство
public final ObjectProperty<Font> fontProperty()
- См. также:
-
getFont(),setFont(Font)
setFont
public final void setFont(Font value)
- Описание свойства:
- Шрифт по умолчанию для текста в подсказке. Если текст подсказки — форматированный текст, этот шрифт может использоваться или нет в зависимости от информации о шрифте, вложенной в форматированный текст, но в любом случае, когда требуется шрифт по умолчанию, будет использоваться этот шрифт.
getFont
public final Font getFont()
- Описание свойства:
- Шрифт по умолчанию для текста в подсказке. Если текст подсказки — форматированный текст, этот шрифт может использоваться или нет в зависимости от информации о шрифте, вложенной в форматированный текст, но в любом случае, когда требуется шрифт по умолчанию, будет использоваться этот шрифт.
showDelayСвойство
public final ObjectProperty<Duration> showDelayProperty()
- Значение по умолчанию:
- 1000 мс
- С:
- 9
- См. также:
-
getShowDelay(),setShowDelay(Duration)
setShowDelay
public final void setShowDelay(Duration showDelay)
- Описание свойства:
- Задержка между входом мыши в фокусированный узел и отображением связанной подсказки пользователю. Задержка по умолчанию составляет 1000 мс.
- Значение по умолчанию:
- 1000 мс
- С:
- 9
getShowDelay
public final Duration getShowDelay()
- Описание свойства:
- Задержка между входом мыши в фокусированный узел и отображением связанной подсказки пользователю. Задержка по умолчанию составляет 1000 мс.
- Значение по умолчанию:
- 1000 мс
- С:
- 9
showDurationСвойство
public final ObjectProperty<Duration> showDurationProperty()
hideDelayProperty(), даже если оставшееся время showDuration меньше, чем время hideDelay. Значение по умолчанию составляет 5000 мс.- Значение по умолчанию:
- 5000 мс
- С:
- 9
- См. также:
-
getShowDuration(),setShowDuration(Duration)
setShowDuration
public final void setShowDuration(Duration showDuration)
- Описание свойства:
- Продолжительность отображения подсказки до тех пор, пока она не будет больше невидима для пользователя. Если курсор мыши покинет элемент управления до завершения showDuration, подсказка останется видимой в течение времени, заданного в
hideDelayProperty(), даже если оставшееся время showDuration меньше, чем время hideDelay. Значение по умолчанию составляет 5000 мс. - Значение по умолчанию:
- 5000 мс
- С:
- 9
getShowDuration
public final Duration getShowDuration()
- Описание свойства:
- Продолжительность отображения подсказки до тех пор, пока она не будет больше невидима для пользователя. Если курсор мыши покинет элемент управления до завершения showDuration, подсказка останется видимой в течение времени, заданного в
hideDelayProperty(), даже если оставшееся время showDuration меньше, чем время hideDelay. Значение по умолчанию составляет 5000 мс. - Значение по умолчанию:
- 5000 мс
- С:
- 9
hideDelayСвойство
public final ObjectProperty<Duration> hideDelayProperty()
- Значение по умолчанию:
- 200 мс
- С:
- 9
- См. также:
-
getHideDelay(),setHideDelay(Duration)
setHideDelay
public final void setHideDelay(Duration hideDelay)
- Описание свойства:
- Продолжительность отображения подсказки после того, как мышь покинула узел. По истечении этого времени подсказка будет скрыта. Значение по умолчанию составляет 200 мс.
- Значение по умолчанию:
- 200 мс
- С:
- 9
getHideDelay
public final Duration getHideDelay()
- Описание свойства:
- Продолжительность отображения подсказки после того, как мышь покинула узел. По истечении этого времени подсказка будет скрыта. Значение по умолчанию составляет 200 мс.
- Значение по умолчанию:
- 200 мс
- С:
- 9
graphicСвойство
public final ObjectProperty<Node> graphicProperty()
content display. Узел, указанный для этой переменной, не может отображаться в другом месте графического дерева, в противном случае будет выброшено исключение IllegalArgumentException. Дополнительные сведения см. в описании класса Node.- См. также:
-
getGraphic(),setGraphic(Node)
setGraphic
public final void setGraphic(Node value)
- Описание свойства:
- Необязательный значок для подсказки. Его можно разместить относительно текста, используя свойство
content display. Узел, указанный для этой переменной, не может отображаться в другом месте графического дерева, в противном случае будет выброшено исключениеIllegalArgumentException. Дополнительные сведения см. в описании классаNode.
getGraphic
public final Node getGraphic()
- Описание свойства:
- Необязательный значок для подсказки. Его можно разместить относительно текста, используя свойство
content display. Узел, указанный для этой переменной, не может отображаться в другом месте графического дерева, в противном случае будет выброшено исключениеIllegalArgumentException. Дополнительные сведения см. в описании классаNode.
contentDisplayСвойство
public final ObjectProperty<ContentDisplay> contentDisplayProperty()
- См. также:
-
getContentDisplay(),setContentDisplay(ContentDisplay)
Установить отображение содержимого
public final void setContentDisplay(ContentDisplay value)
- Описание свойства:
- Определяет позиционирование графики относительно текста.
Получить отображение содержимого
public final ContentDisplay getContentDisplay()
- Описание свойства:
- Определяет позиционирование графики относительно текста.
graphicTextGapProperty
public final DoubleProperty graphicTextGapProperty()
- См. также:
-
getGraphicTextGap(),setGraphicTextGap(double)
УстановитьGraphicTextGap
public final void setGraphicTextGap(double value)
- Описание свойства:
- Размер промежутка между графикой и текстом
ПолучитьGraphicTextGap
public final double getGraphicTextGap()
- Описание свойства:
- Размер промежутка между графикой и текстом
isActivated
public final boolean isActivated()
- Описание свойства:
- Обычно всплывающая подсказка "активируется", когда курсор мыши перемещается над элементом управления. Обычно существует некоторая задержка между моментом, когда всплывающая подсказка становится "активированной", и моментом ее фактического отображения. Подробности (например, продолжительность задержки и т. д.) оставляются на усмотрение реализации интерфейса.
activatedProperty
public final ReadOnlyBooleanProperty activatedProperty()
- См. также:
isActivated()
getClassCssMetaData
public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()
- Возвращает:
- CssMetaData, связанный с этим классом, который может включать CssMetaData его суперклассов.
- С:
- JavaFX 8.0
getCssMetaData
public List<CssMetaData<? extends Styleable,?>> getCssMetaData()
- Определено в:
-
getCssMetaDataв интерфейсеStyleable - Переопределяет:
-
getCssMetaDataв классеPopupControl - Возвращает:
- 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.