Класс PopupWindow
- javafx.stage.Window
-
- javafx.stage.PopupWindow
Все реализованные интерфейсы:
Прямые известные подклассы:
public abstract class PopupWindow extends Window
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Указывает, следует ли обрабатывать событие, вызвавшее скрытие всплывающего окна.BooleanPropertyhideOnEscapeУказывает, следует ли скрывать PopupWindow при нажатии клавиши Escape без обработки, когда всплывающее окно имеет фокус.ObjectProperty<EventHandler<Event>>onAutoHideВызывается после выполнения autoHide.ReadOnlyObjectProperty<Node>ownerNodeУзел, являющийся владельцем этого всплывающего окна.ReadOnlyObjectProperty<Window>ownerWindowОкно, являющееся родителем этого всплывающего окна.
-
Краткое описание вложенных классов
Вложенные классы Модификатор и тип Класс и описание 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()Указывает, следует ли скрывать PopupWindow при нажатии клавиши 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, getEventDispatcher, getHeight, getOnCloseRequest, getOnHidden, getOnHiding, getOnShowing, getOnShown, getOpacity, getProperties, getScene, getUserData, getWidth, getX, getY, hasProperties, heightProperty, isFocused, isShowing, onCloseRequestProperty, onHiddenProperty, onHidingProperty, onShowingProperty, onShownProperty, opacityProperty, removeEventFilter, removeEventHandler, requestFocus, sceneProperty, setEventDispatcher, setEventHandler, setHeight, setOnCloseRequest, setOnHidden, setOnHiding, setOnShowing, setOnShown, setOpacity, setUserData, setWidth, setX, setY, show, showingProperty, sizeToScene, widthProperty, xProperty, yProperty
-
-
Подробное описание свойств
-
ownerWindow
public final ReadOnlyObjectProperty<Window> ownerWindowProperty
Окно, являющееся родителем этого всплывающего окна. Все всплывающие окна должны иметь окно-родитель.См. также:
-
ownerNode
public final ReadOnlyObjectProperty<Node> ownerNodeProperty
Узел, являющийся владельцем этого всплывающего окна. Все всплывающие окна должны иметь окно-родитель, но не обязательно должны быть связаны с узлом-владельцем. Если у всплывающего окна с автоматическим скрытием есть узел-владелец, нажатие мыши внутри узла-владельца не приведет к скрытию всплывающего окна.См. также:
-
autoFix
public final BooleanProperty autoFixProperty
Эта переменная указывает, нужно ли автоматически корректировать позицию всплывающего окна при его отображении, чтобы оно не выходило за пределы экрана.Значение по умолчанию:
true
См. также:
-
autoHide
public final BooleanProperty autoHideProperty
Указывает, следует ли автоматически скрывать всплывающие окна. Если всплывающее окно теряет фокус, а autoHide равно true, то всплывающее окно будет автоматически скрыто.Исключением является случай, когда узел-владелец указан с помощью
show(javafx.scene.Node, double, double). Получение фокуса узлом-владельцем не приведет к скрытию PopupWindow.Значение по умолчанию:
false
См. также:
-
onAutoHide
public final ObjectProperty<EventHandler<Event>> onAutoHideProperty
Вызывается после выполнения autoHide.См. также:
-
hideOnEscape
public final BooleanProperty hideOnEscapeProperty
Указывает, должно ли всплывающее окно скрываться при нажатии необработанной клавиши Escape, когда у него есть фокус.Значение по умолчанию:
true
См. также:
-
consumeAutoHidingEvents
public final BooleanProperty consumeAutoHidingEventsProperty
Указывает, должен ли быть обработан тот событие, которое привело к скрытию всплывающего окна. Обработка события предотвращает его от срабатывания некоторых дополнительных UI-реакций в окне-родителе всплывающего окна.Значение по умолчанию:
true
С тех пор как:
JavaFX 2.2
-
anchorX
public final ReadOnlyDoubleProperty anchorXProperty
Указывает координату x точки привязки всплывающего окна на экране. ЕслиanchorLocationустановлено вWINDOW_TOP_LEFTилиWINDOW_BOTTOM_LEFT, тоxиanchorXзначения будут идентичны.С тех пор как:
JavaFX 8.0
См. также:
-
anchorY
public final ReadOnlyDoubleProperty anchorYProperty
Указывает координату y точки привязки всплывающего окна на экране. ЕслиanchorLocationустановлено вWINDOW_TOP_LEFTилиWINDOW_TOP_RIGHT, тоyиanchorYзначения будут идентичны.С тех пор как:
JavaFX 8.0
См. также:
-
anchorLocation
public final ObjectProperty<PopupWindow.AnchorLocation> anchorLocationProperty
Указывает точку привязки всплывающего окна, используемую при позиционировании. Точка может быть установлена в угол всплывающего окна или в угол его содержимого. В этом контексте углы содержимого определяются из границ компоновки корневого узла всплывающего окна.В общем случае изменение точки привязки не повлияет на текущую позицию окна. Вместо этого
anchorXиanchorYзначения пересчитываются, чтобы соответствовать новой точке привязки.С тех пор как:
JavaFX 8.0
См. также:
-
-
Подробное описание конструкторов
-
PopupWindow
public PopupWindow()
-
-
Подробное описание методов
-
getOwnerWindow
public final Window getOwnerWindow()
Возвращает значение свойства ownerWindow.Описание свойства:
Окно, являющееся родителем этого всплывающего окна. Все всплывающие окна должны иметь окно-родитель.
-
ownerWindowProperty
public final ReadOnlyObjectProperty<Window> ownerWindowProperty()
Окно, являющееся родителем этого всплывающего окна. Все всплывающие окна должны иметь окно-родитель.См. также:
-
getOwnerNode
public final Node getOwnerNode()
Возвращает значение свойства ownerNode.Описание свойства:
Узел, являющийся владельцем этого всплывающего окна. Все всплывающие окна должны иметь окно-родитель, но не обязаны быть связанными с узлом-владельцем. Если у всплывающего окна автоскрытия есть узел-владелец, нажатие мыши внутри узла-владельца не приводит к скрытию всплывающего окна.
-
ownerNodeProperty
public final ReadOnlyObjectProperty<Node> ownerNodeProperty()
Узел, являющийся владельцем этого всплывающего окна. Все всплывающие окна должны иметь окно-родитель, но не обязаны быть связанными с узлом-владельцем. Если у всплывающего окна автоскрытия есть узел-владелец, нажатие мыши внутри узла-владельца не приводит к скрытию всплывающего окна.См. также:
-
setScene
protected final void setScene(Scene scene)
Примечание для подклассов: сцена, используемая PopupWindow, очень специфически управляется PopupWindow. Этот метод переопределяется для выброса UnsupportedOperationException. Вы не можете указать свою собственную сцену.
-
setAutoFix
public final void setAutoFix(boolean value)
Устанавливает значение свойства autoFix.Описание свойства:
Эта вспомогательная переменная указывает, нужно ли автоматически корректировать положение всплывающего окна при его отображении, чтобы оно не выходило за пределы экрана.
Значение по умолчанию:
true
-
isAutoFix
public final boolean isAutoFix()
Возвращает значение свойства autoFix.Описание свойства:
Эта вспомогательная переменная указывает, нужно ли автоматически корректировать положение всплывающего окна при его отображении, чтобы оно не выходило за пределы экрана.
Значение по умолчанию:
true
-
autoFixProperty
public final BooleanProperty autoFixProperty()
Эта вспомогательная переменная указывает, нужно ли автоматически корректировать положение всплывающего окна при его отображении, чтобы оно не выходило за пределы экрана.Значение по умолчанию:
true
См. также:
-
setAutoHide
public final void setAutoHide(boolean value)
Устанавливает значение свойства autoHide.Описание свойства:
Указывает, нужно ли автоматически скрывать всплывающие окна. Если всплывающее окно теряет фокус, а autoHide равно true, то всплывающее окно будет автоматически скрыто.
Исключением является случай, когда узел-владелец задан с помощью
show(javafx.scene.Node, double, double). Получение фокуса узлом-владельцем не приведет к скрытию PopupWindow.Значение по умолчанию:
false
-
isAutoHide
public final boolean isAutoHide()
Возвращает значение свойства autoHide.Описание свойства:
Указывает, нужно ли автоматически скрывать всплывающие окна. Если всплывающее окно теряет фокус, а autoHide равно true, то всплывающее окно будет автоматически скрыто.
Исключением является случай, когда узел-владелец задан с помощью
show(javafx.scene.Node, double, double). Получение фокуса узлом-владельцем не приведет к скрытию PopupWindow.Значение по умолчанию:
false
-
autoHideProperty
public final BooleanProperty autoHideProperty()
Указывает, нужно ли автоматически скрывать всплывающие окна. Если всплывающее окно теряет фокус, а autoHide равно true, то всплывающее окно будет автоматически скрыто.Исключением является случай, когда узел-владелец задан с помощью
show(javafx.scene.Node, double, double). Получение фокуса узлом-владельцем не приведет к скрытию PopupWindow.Значение по умолчанию:
false
См. также:
-
setOnAutoHide
public final void setOnAutoHide(EventHandler<Event> value)
Устанавливает значение свойства onAutoHide.Описание свойства:
Вызывается после выполнения autoHide.
-
getOnAutoHide
public final EventHandler<Event> getOnAutoHide()
Возвращает значение свойства onAutoHide.Описание свойства:
Вызывается после выполнения autoHide.
-
onAutoHideProperty
public final ObjectProperty<EventHandler<Event>> onAutoHideProperty()
Вызывается после выполнения autoHide.См. также:
-
setHideOnEscape
public final void setHideOnEscape(boolean value)
Устанавливает значение свойства hideOnEscape.Описание свойства:
Указывает, нужно ли скрывать PopupWindow при нажатии необработанной клавиши Escape, когда всплывающее окно имеет фокус.
Значение по умолчанию:
true
-
isHideOnEscape
public final boolean isHideOnEscape()
Возвращает значение свойства hideOnEscape.Описание свойства:
Указывает, нужно ли скрывать PopupWindow при нажатии необработанной клавиши Escape, когда всплывающее окно имеет фокус.
Значение по умолчанию:
true
-
hideOnEscapeProperty
public final BooleanProperty hideOnEscapeProperty()
Указывает, нужно ли скрывать PopupWindow при нажатии необработанной клавиши Escape, когда всплывающее окно имеет фокус.Значение по умолчанию:
true
См. также:
-
setConsumeAutoHidingEvents
public final void setConsumeAutoHidingEvents(boolean value)
Устанавливает значение свойства consumeAutoHidingEvents.Описание свойства:
Указывает, нужно ли потреблять событие, которое вызвало скрытие всплывающего окна. Потребление события предотвращает срабатывание дополнительной реакции пользовательского интерфейса в окне-родителе всплывающего окна.
Значение по умолчанию:
true
С версии:
JavaFX 2.2
-
getConsumeAutoHidingEvents
public final boolean getConsumeAutoHidingEvents()
Возвращает значение свойства consumeAutoHidingEvents.Описание свойства:
Указывает, нужно ли потреблять событие, которое вызвало скрытие всплывающего окна. Потребление события предотвращает срабатывание дополнительной реакции пользовательского интерфейса в окне-родителе всплывающего окна.
Значение по умолчанию:
true
С версии:
JavaFX 2.2
-
consumeAutoHidingEventsProperty
public final BooleanProperty consumeAutoHidingEventsProperty()
Указывает, нужно ли потреблять событие, которое вызвало скрытие всплывающего окна. Потребление события предотвращает срабатывание дополнительной реакции пользовательского интерфейса в окне-родителе всплывающего окна.Значение по умолчанию:
true
С версии:
JavaFX 2.2
-
show
public void show(Window owner)
Отобразить всплывающее окно.Параметры:
owner- Владелец всплывающего окна. Не должно быть null.Исключения:
NullPointerException- если owner null
-
show
public void show(Node ownerNode, double anchorX, double anchorY)Отображает всплывающее окно в указанном месте на экране. Окно всплывающего окна позиционируется таким образом, что его точка привязки (anchorLocation) отображается в указанныхanchorXиanchorYкоординатах.Всплывающее окно ассоциируется с указанным узлом-владельцем.
Window, содержащее узел-владелец в момент вызова, становится окном-родителем отображенного всплывающего окна.Обратите внимание, что когда
autoHideProperty()установлено в true, нажатие мыши на узел-владелец не приведет к скрытию PopupWindow.Параметры:
ownerNode- Узел-владелец всплывающего окна. Не должен быть null и должен быть связан с окном.Исключения:
NullPointerException- если ownerNode null
-
show
public void show(Window ownerWindow, double anchorX, double anchorY)Отображает всплывающее окно в указанном месте на экране. Окно всплывающего окна позиционируется таким образом, что его точка привязки (anchorLocation) отображается в указанныхanchorXиanchorYкоординатах.Параметры:
ownerWindow- Владелец всплывающего окна. Не должен быть null.Исключения:
NullPointerException- если ownerWindow null
-
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
См. также:
-
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
См. также:
-
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
См. также:
-
© 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.