- java.lang.Object
-
- javafx.stage.Window
-
- javafx.stage.PopupWindow
-
- Все реализованные интерфейсы:
EventTarget
- Непосредственные подклассы:
-
Popup,PopupControl
public abstract class PopupWindow extends Window
PopupWindow — родительский класс для различных типов всплывающих окон, включаяPopupиTooltip, иContextMenu.PopupWindow — это вторичное окно без декораций окна или панели заголовка. Оно не отображается в ОС как окно верхнего уровня. Обычно используется для подсказок, уведомлений, раскрывающихся списков, меню и т. д.
PopupWindow не может быть показан без владельца. PopupWindow требует, чтобы окно-владелец существовало для отображения. Однако можно создать PopupWindow заранее и просто установить владельца (или изменить владельца) перед первым отображением. Попытка изменить владельца, пока PopupWindow отображается, приведет к исключению IllegalStateException.
PopupWindow encapsulates значительную часть поведения и функциональности, характерной для всплывающих окон, такой как возможность закрытия при нажатии клавиши «Esc» или возможность скрытия всех дочерних всплывающих окон при скрытии этого окна. Эти возможности могут быть включены или выключены с помощью свойств.
- С момента:
- JavaFX 2.0
-
Краткое описание свойств
Свойства Тип Свойство Описание ObjectProperty<PopupWindow.AnchorLocation>anchorLocationУказывает точку якорной точки всплывающего окна, используемую в позиционировании всплывающего окна.ReadOnlyDoublePropertyanchorXУказывает координату x якорной точки всплывающего окна на экране.ReadOnlyDoublePropertyanchorYУказывает координату y якорной точки всплывающего окна на экране.BooleanPropertyautoFixЭта удобная переменная указывает, следует ли автоматически исправлять позицию всплывающего окна при его отображении, чтобы оно не оказалось за пределами экрана.BooleanPropertyautoHideУказывает, следует ли автоматически скрывать всплывающие окна.BooleanPropertyconsumeAutoHidingEventsУказывает, следует ли потреблять событие, вызвавшее скрытие Popup.BooleanPropertyhideOnEscapeУказывает, следует ли скрывать PopupWindow при нажатии необработанной клавиши Escape, когда всплывающее окно имеет фокус.ObjectProperty<EventHandler<Event>>onAutoHideВызывается после выполнения autoHide.ReadOnlyObjectProperty<Node>ownerNodeУзел, который является владельцем этого всплывающего окна.ReadOnlyObjectProperty<Window>ownerWindowОкно, являющееся родителем этого всплывающего окна.-
Свойства, унаследованные от класса javafx.stage.Window
eventDispatcher, focused, forceIntegerRenderScale, height, onCloseRequest, onHidden, onHiding, onShowing, onShown, opacity, outputScaleX, outputScaleY, renderScaleX, renderScaleY, scene, showing, width, x, y
-
-
Краткое описание вложенных классов
Вложенные классы Модификатор и тип Класс Описание static classPopupWindow.AnchorLocationКонстанты расположения якорной точки для выбора якорной точки всплывающего окна.
-
Краткое описание конструкторов
Конструкторы Конструктор Описание PopupWindow()
-
Краткое описание методов
Все методыМетоды экземпляраКонкретные методы Модификатор и тип Метод Описание ObjectProperty<PopupWindow.AnchorLocation>anchorLocationProperty()Устанавливает точку привязки всплывающего окна, которая используется для позиционирования всплывающего окна.ReadOnlyDoublePropertyanchorXProperty()Устанавливает координату x точки привязки всплывающего окна на экране.ReadOnlyDoublePropertyanchorYProperty()Устанавливает координату y точки привязки всплывающего окна на экране.BooleanPropertyautoFixProperty()Эта удобная переменная указывает, следует ли автоматически корректировать позицию всплывающего окна при его отображении, чтобы оно не выходило за пределы экрана.BooleanPropertyautoHideProperty()Указывает, следует ли автоматически скрывать всплывающее окно.BooleanPropertyconsumeAutoHidingEventsProperty()Указывает, следует ли обрабатывать событие, вызвавшее скрытие всплывающего окна.PopupWindow.AnchorLocationgetAnchorLocation()Получает значение свойства anchorLocation.doublegetAnchorX()Получает значение свойства anchorX.doublegetAnchorY()Получает значение свойства anchorY.booleangetConsumeAutoHidingEvents()Получает значение свойства consumeAutoHidingEvents.EventHandler<Event>getOnAutoHide()Получает значение свойства onAutoHide.NodegetOwnerNode()Получает значение свойства ownerNode.WindowgetOwnerWindow()Получает значение свойства ownerWindow.voidhide()Скрывает это всплывающее окно и все его дочерние элементы.BooleanPropertyhideOnEscapeProperty()Указывает, должно ли всплывающее окно скрываться при нажатии клавиши Escape, если оно имеет фокус.booleanisAutoFix()Получает значение свойства autoFix.booleanisAutoHide()Получает значение свойства autoHide.booleanisHideOnEscape()Получает значение свойства hideOnEscape.ObjectProperty<EventHandler<Event>>onAutoHideProperty()Вызывается после выполнения autoHide.ReadOnlyObjectProperty<Node>ownerNodeProperty()Узел, являющийся владельцем этого всплывающего окна.ReadOnlyObjectProperty<Window>ownerWindowProperty()Окно, являющееся родителем этого всплывающего окна.voidsetAnchorLocation(PopupWindow.AnchorLocation value)Устанавливает значение свойства anchorLocation.voidsetAnchorX(double value)Устанавливает значение свойства anchorX.voidsetAnchorY(double value)Устанавливает значение свойства anchorY.voidsetAutoFix(boolean value)Устанавливает значение свойства autoFix.voidsetAutoHide(boolean value)Устанавливает значение свойства autoHide.voidsetConsumeAutoHidingEvents(boolean value)Устанавливает значение свойства consumeAutoHidingEvents.voidsetHideOnEscape(boolean value)Устанавливает значение свойства hideOnEscape.voidsetOnAutoHide(EventHandler<Event> value)Устанавливает значение свойства onAutoHide.protected voidsetScene(Scene scene)Примечание для подклассов: сцена, используемая PopupWindow, очень специфическим образом управляется PopupWindow.voidshow(Node ownerNode, double anchorX, double anchorY)Отображает всплывающее окно в указанном месте на экране.voidshow(Window owner)Отображает всплывающее окно.voidshow(Window ownerWindow, double anchorX, double anchorY)Отображает всплывающее окно в указанном месте на экране.-
Методы, унаследованные от класса 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
-
-
Подробное описание свойств
-
ownerWindow
public final ReadOnlyObjectProperty<Window> ownerWindowProperty
Окно, являющееся родителем этого всплывающего окна. Все всплывающие окна должны иметь родительское окно.- См. также:
getOwnerWindow()
-
ownerNode
public final ReadOnlyObjectProperty<Node> ownerNodeProperty
Узел, являющийся владельцем этого всплывающего окна. Все всплывающие окна должны иметь родительское окно, но не обязаны быть связаны с узлом-владельцем. Если у автоскрывающегося всплывающего окна есть узел-владелец, нажатие мыши внутри узла-владельца не приводит к скрытию всплывающего окна.- См. также:
getOwnerNode()
-
autoFix
public final BooleanProperty autoFixProperty
Эта переменная удобства указывает, следует ли автоматически корректировать положение всплывающего окна при его отображении, чтобы оно не выходило за пределы экрана.- Значение по умолчанию:
- true
- См. также:
-
isAutoFix(),setAutoFix(boolean)
-
autoHide
public final BooleanProperty autoHideProperty
Указывает, следует ли автоматически скрывать всплывающие окна. Если всплывающее окно теряет фокус и autoHide равно true, то всплывающее окно будет автоматически скрыто.Единственным исключением является случай, когда узел-владелец задается с помощью
show(javafx.scene.Node, double, double). При получении фокуса узлом-владельцем всплывающее окно не будет скрыто.- Значение по умолчанию:
- false
- См. также:
-
isAutoHide(),setAutoHide(boolean)
-
onAutoHide
public final ObjectProperty<EventHandler<Event>> onAutoHideProperty
Вызывается после выполнения autoHide.- См. также:
-
getOnAutoHide(),setOnAutoHide(EventHandler)
-
hideOnEscape
public final BooleanProperty hideOnEscapeProperty
Указывает, следует ли скрывать всплывающее окно при нажатии клавиши Escape, если она не обрабатывается, в то время как всплывающее окно имеет фокус.- Значение по умолчанию:
- true
- См. также:
-
isHideOnEscape(),setHideOnEscape(boolean)
-
consumeAutoHidingEvents
public final BooleanProperty consumeAutoHidingEventsProperty
Указывает, следует ли потреблять событие, которое вызвало скрытие всплывающего окна. Потребление события предотвращает его от триггеринга дополнительного UI-отклика в окне-владельце всплывающего окна.- Значение по умолчанию:
- true
- С момента:
- JavaFX 2.2
- См. также:
-
getConsumeAutoHidingEvents(),setConsumeAutoHidingEvents(boolean)
-
anchorX
public final ReadOnlyDoubleProperty anchorXProperty
Указывает координату x точки привязки всплывающего окна на экране. ЕслиanchorLocationустановлено вWINDOW_TOP_LEFTилиWINDOW_BOTTOM_LEFTзначенияxиanchorXбудут идентичны.- С момента:
- JavaFX 8.0
- См. также:
-
getAnchorX(),setAnchorX(double)
-
anchorY
public final ReadOnlyDoubleProperty anchorYProperty
Указывает координату y точки привязки всплывающего окна на экране. ЕслиanchorLocationустановлено вWINDOW_TOP_LEFTилиWINDOW_TOP_RIGHTзначенияyиanchorYбудут идентичны.- С момента:
- JavaFX 8.0
- См. также:
-
getAnchorY(),setAnchorY(double)
-
anchorLocation
public final ObjectProperty<PopupWindow.AnchorLocation> anchorLocationProperty
Указывает точку привязки всплывающего окна, используемую при позиционировании всплывающего окна. Точка может быть установлена в угол всплывающего окна или угол его содержимого. В этом контексте углы содержимого выводятся из границ макета узла-корня всплывающего окна.В общем случае изменение точки привязки не изменяет текущего положения окна. Вместо этого, значения
anchorXиanchorYпересчитываются для соответствия новой точке привязки.- С момента:
- JavaFX 8.0
- См. также:
-
getAnchorLocation(),setAnchorLocation(PopupWindow.AnchorLocation)
-
-
Подробное описание конструкторов
-
PopupWindow
public PopupWindow()
-
-
Method Detail - Подробное описание методов
-
getOwnerWindow
public final Window getOwnerWindow()
Получает значение свойства ownerWindow.- Property description:
- Окно, которое является родительским для этого всплывающего окна. Все всплывающие окна должны иметь окно-владелец.
-
ownerWindowProperty
public final ReadOnlyObjectProperty<Window> ownerWindowProperty()
Окно, которое является родительским для этого всплывающего окна. Все всплывающие окна должны иметь окно-владелец.- See Also:
getOwnerWindow()
-
getOwnerNode
public final Node getOwnerNode()
Получает значение свойства ownerNode.- Property description:
- Узел, который является владельцем этого всплывающего окна. Все всплывающие окна должны иметь окно-владелец, но не обязательно должны быть связаны с узлом-владельцем. Если всплывающее окно с автоматическим скрытием имеет узел-владелец, нажатие мыши внутри узла-владельца не приведет к скрытию всплывающего окна.
-
ownerNodeProperty
public final ReadOnlyObjectProperty<Node> ownerNodeProperty()
Узел, который является владельцем этого всплывающего окна. Все всплывающие окна должны иметь окно-владелец, но не обязательно должны быть связаны с узлом-владельцем. Если всплывающее окно с автоматическим скрытием имеет узел-владелец, нажатие мыши внутри узла-владельца не приведет к скрытию всплывающего окна.- See Also:
getOwnerNode()
-
setScene
protected final void setScene(Scene scene)
Примечание для подклассов: сцена, используемая PopupWindow, очень специфично управляется PopupWindow. Этот метод переопределен для выброса UnsupportedOperationException. Вы не можете указать свою собственную сцену.
-
setAutoFix
public final void setAutoFix(boolean value)
Задает значение свойства autoFix.- Property description:
- Эта переменная удобства указывает, следует ли при отображении всплывающего окна автоматически корректировать его положение, чтобы оно не оказалось за пределами экрана.
- Default value:
- true
-
isAutoFix
public final boolean isAutoFix()
Получает значение свойства autoFix.- Property description:
- Эта переменная удобства указывает, следует ли при отображении всплывающего окна автоматически корректировать его положение, чтобы оно не оказалось за пределами экрана.
- Default value:
- true
-
autoFixProperty
public final BooleanProperty autoFixProperty()
Эта переменная удобства указывает, следует ли при отображении всплывающего окна автоматически корректировать его положение, чтобы оно не оказалось за пределами экрана.- Default value:
- true
- See Also:
-
isAutoFix(),setAutoFix(boolean)
-
setAutoHide
public final void setAutoHide(boolean value)
Задает значение свойства autoHide.- Property description:
- Указывает, должны ли всплывающие окна автоматически скрываться. Если всплывающее окно теряет фокус, а autoHide имеет значение true, то всплывающее окно будет скрыто автоматически.
Единственное исключение — когда owner Node указан с использованием
show(javafx.scene.Node, double, double). Фокусировка owner Node не скроет PopupWindow. - Default value:
- false
-
isAutoHide
public final boolean isAutoHide()
Получает значение свойства autoHide.- Property description:
- Указывает, должны ли всплывающие окна автоматически скрываться. Если всплывающее окно теряет фокус, а autoHide имеет значение true, то всплывающее окно будет скрыто автоматически.
Единственное исключение — когда owner Node указан с использованием
show(javafx.scene.Node, double, double). Фокусировка owner Node не скроет PopupWindow. - Default value:
- false
-
autoHideProperty
public final BooleanProperty autoHideProperty()
Указывает, должны ли всплывающие окна автоматически скрываться. Если всплывающее окно теряет фокус, а autoHide имеет значение true, то всплывающее окно будет скрыто автоматически.Единственное исключение — когда owner Node указан с использованием
show(javafx.scene.Node, double, double). Фокусировка owner Node не скроет PopupWindow.- Default value:
- false
- See Also:
-
isAutoHide(),setAutoHide(boolean)
-
setOnAutoHide
public final void setOnAutoHide(EventHandler<Event> value)
Задает значение свойства onAutoHide.- Property description:
- Вызывается после запуска autoHide.
-
getOnAutoHide
public final EventHandler<Event> getOnAutoHide()
Получает значение свойства onAutoHide.- Property description:
- Вызывается после запуска autoHide.
-
onAutoHideProperty
public final ObjectProperty<EventHandler<Event>> onAutoHideProperty()
Вызывается после запуска autoHide.- See Also:
-
getOnAutoHide(),setOnAutoHide(EventHandler)
-
setHideOnEscape
public final void setHideOnEscape(boolean value)
Задает значение свойства hideOnEscape.- Property description:
- Указывает, следует ли скрывать PopupWindow при нажатии необработанной клавиши Escape, пока всплывающее окно находится в фокусе.
- Default value:
- true
-
isHideOnEscape
public final boolean isHideOnEscape()
Получает значение свойства hideOnEscape.- Property description:
- Указывает, следует ли скрывать PopupWindow при нажатии необработанной клавиши Escape, пока всплывающее окно находится в фокусе.
- Default value:
- true
-
hideOnEscapeProperty
public final BooleanProperty hideOnEscapeProperty()
Указывает, следует ли скрывать PopupWindow при нажатии необработанной клавиши Escape, пока всплывающее окно находится в фокусе.- Default value:
- true
- See Also:
-
isHideOnEscape(),setHideOnEscape(boolean)
-
setConsumeAutoHidingEvents
public final void setConsumeAutoHidingEvents(boolean value)
Задает значение свойства consumeAutoHidingEvents.- Property description:
- Указывает, следует ли потреблять событие, которое привело к скрытию Popup. Потребление события предотвращает его вызов некоторого дополнительного ответа пользовательского интерфейса в окне-владельце Popup.
- Default value:
- true
- Since:
- JavaFX 2.2
-
getConsumeAutoHidingEvents
public final boolean getConsumeAutoHidingEvents()
Получает значение свойства consumeAutoHidingEvents.- Property description:
- Указывает, следует ли потреблять событие, которое привело к скрытию Popup. Потребление события предотвращает его вызов некоторого дополнительного ответа пользовательского интерфейса в окне-владельце Popup.
- Default value:
- true
- Since:
- JavaFX 2.2
-
consumeAutoHidingEventsProperty
public final BooleanProperty consumeAutoHidingEventsProperty()
Указывает, следует ли потреблять событие, которое привело к скрытию Popup. Потребление события предотвращает его вызов некоторого дополнительного ответа пользовательского интерфейса в окне-владельце Popup.- Default value:
- true
- Since:
- JavaFX 2.2
- See Also:
-
getConsumeAutoHidingEvents(),setConsumeAutoHidingEvents(boolean)
-
show
public void show(Window owner)
Показать всплывающее окно.- Parameters:
-
owner- Владелец всплывающего окна. Это не должно быть null. - Throws:
-
NullPointerException- если owner имеет значение null -
IllegalArgumentException- если указанное окно владельца создаст цикл в иерархии окон
-
-
show
public void show(Node ownerNode, double anchorX, double anchorY)
Отображает всплывающее окно в указанном месте на экране. Окно всплывающего сообщения расположено таким образом, что его точка привязки (anchorLocation) отображается в указанныхanchorXиanchorYкоординатах.Всплывающее окно ассоциируется с указанным узлом-владельцем.
Window, содержащий узел-владелец в момент вызова, становится окном-владельцем отображаемого всплывающего окна.Обратите внимание, что при установке
autoHideв значение true, нажатие мыши на узел-владелец не будет скрывать PopupWindow.- Параметры:
-
ownerNode- Узел-владелец всплывающего окна. Он не должен быть null и должен быть связан с окном. -
anchorX- Позиция по оси X точки привязки всплывающего окна в координатах экрана -
anchorY- Позиция по оси Y точки привязки всплывающего окна в координатах экрана - Исключения:
-
NullPointerException- если ownerNode равно null -
IllegalArgumentException- если указанный узел-владелец не связан с окном или когда окно создаст цикл в иерархии окон
-
show
public void show(Window ownerWindow, double anchorX, double anchorY)
Отображает всплывающее окно в указанном месте на экране. Окно всплывающего сообщения расположено таким образом, что его точка привязки (anchorLocation) отображается в указанныхanchorXиanchorYкоординатах.- Параметры:
-
ownerWindow- Владелец всплывающего окна. Не должен быть null. -
anchorX- Позиция по оси X точки привязки всплывающего окна в координатах экрана -
anchorY- Позиция по оси Y точки привязки всплывающего окна в координатах экрана - Исключения:
-
NullPointerException- если ownerWindow равно null -
IllegalArgumentException- если указанное окно-владелец создаст цикл в иерархии окон
-
hide
public void hide()
Скрывает это всплывающее окно и все его дочерние элементы
-
setAnchorX
public final void setAnchorX(double value)
Устанавливает значение свойства anchorX.- Описание свойства:
- Указывает координату по оси X точки привязки всплывающего окна на экране. Если
anchorLocationустановлено вWINDOW_TOP_LEFTилиWINDOW_BOTTOM_LEFT, значенияxиanchorXбудут идентичны. - С момента:
- JavaFX 8.0
-
getAnchorX
public final double getAnchorX()
Получает значение свойства anchorX.- Описание свойства:
- Указывает координату по оси X точки привязки всплывающего окна на экране. Если
anchorLocationустановлено вWINDOW_TOP_LEFTилиWINDOW_BOTTOM_LEFT, значенияxиanchorXбудут идентичны. - С момента:
- JavaFX 8.0
-
anchorXProperty
public final ReadOnlyDoubleProperty anchorXProperty()
Указывает координату по оси X точки привязки всплывающего окна на экране. ЕслиanchorLocationустановлено вWINDOW_TOP_LEFTилиWINDOW_BOTTOM_LEFT, значенияxиanchorXбудут идентичны.- С момента:
- JavaFX 8.0
- См. также:
-
getAnchorX(),setAnchorX(double)
-
setAnchorY
public final void setAnchorY(double value)
Устанавливает значение свойства anchorY.- Описание свойства:
- Указывает координату по оси Y точки привязки всплывающего окна на экране. Если
anchorLocationустановлено вWINDOW_TOP_LEFTилиWINDOW_TOP_RIGHT, значенияyиanchorYбудут идентичны. - С момента:
- JavaFX 8.0
-
getAnchorY
public final double getAnchorY()
Получает значение свойства anchorY.- Описание свойства:
- Указывает координату по оси Y точки привязки всплывающего окна на экране. Если
anchorLocationустановлено вWINDOW_TOP_LEFTилиWINDOW_TOP_RIGHT, значенияyиanchorYбудут идентичны. - С момента:
- JavaFX 8.0
-
anchorYProperty
public final ReadOnlyDoubleProperty anchorYProperty()
Указывает координату по оси Y точки привязки всплывающего окна на экране. ЕслиanchorLocationустановлено вWINDOW_TOP_LEFTилиWINDOW_TOP_RIGHT, значенияyиanchorYбудут идентичны.- С момента:
- JavaFX 8.0
- См. также:
-
getAnchorY(),setAnchorY(double)
-
setAnchorLocation
public final void setAnchorLocation(PopupWindow.AnchorLocation value)
Устанавливает значение свойства anchorLocation.- Описание свойства:
- Указывает точку привязки всплывающего окна, используемую при позиционировании всплывающего окна. Точка может быть установлена в угол окна всплывающего сообщения или в угол его содержимого. В этом контексте углы содержимого выводятся из границ компоновки корневого узла всплывающего окна.
В общем случае изменение расположения точки привязки не изменит текущее положение окна. Вместо этого значения
anchorXиanchorYпересчитываются для соответствия новой точке привязки. - С момента:
- JavaFX 8.0
-
getAnchorLocation
public final PopupWindow.AnchorLocation getAnchorLocation()
Получает значение свойства anchorLocation.- Описание свойства:
- Указывает точку привязки всплывающего окна, используемую при позиционировании всплывающего окна. Точка может быть установлена в угол окна всплывающего сообщения или в угол его содержимого. В этом контексте углы содержимого выводятся из границ компоновки корневого узла всплывающего окна.
В общем случае изменение расположения точки привязки не изменит текущее положение окна. Вместо этого значения
anchorXиanchorYпересчитываются для соответствия новой точке привязки. - С момента:
- JavaFX 8.0
-
anchorLocationProperty
public final ObjectProperty<PopupWindow.AnchorLocation> anchorLocationProperty()
Указывает точку привязки всплывающего окна, используемую при позиционировании всплывающего окна. Точка может быть установлена в угол окна всплывающего сообщения или в угол его содержимого. В этом контексте углы содержимого выводятся из границ компоновки корневого узла всплывающего окна.В общем случае изменение расположения точки привязки не изменит текущее положение окна. Вместо этого значения
anchorXиanchorYпересчитываются для соответствия новой точке привязки.- С момента:
- JavaFX 8.0
- См. также:
-
getAnchorLocation(),setAnchorLocation(PopupWindow.AnchorLocation)
-
© 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.