Класс PopupWindow
- Все реализованные интерфейсы:
EventTarget
- Прямые известные подклассы:
-
Popup,PopupControl
public abstract class PopupWindow extends Window
Popup и Tooltip, а также ContextMenu. Окно PopupWindow является вторичным окном без декораций окна или панели заголовка. Оно не отображается в ОС как окно верхнего уровня. Обычно оно используется для подсказок, уведомлений, выпадающих меню и т.д.
PopupWindow не может быть показан без владельца. PopupWindow требует наличия окна-владельца для отображения. Однако, можно создать PopupWindow заранее и просто установить владельца (или изменить владельца) перед первым отображением. Попытка изменить владельца во время отображения PopupWindow приведет к исключению IllegalStateException.
PopupWindow содержит большую часть поведения и функциональности, характерной для всплывающих окон, например, возможность закрытия при нажатии клавиши «Esc» или возможность скрытия всех дочерних всплывающих окон при скрытии этого окна. Эти возможности можно включить или выключить с помощью свойств.
- С:
- JavaFX 2.0
Краткое описание полей
| Тип | Свойство | Описание |
|---|---|---|
final ObjectProperty<PopupWindow.AnchorLocation> |
anchorLocation |
Задает точку привязки всплывающего окна, которая используется при позиционировании всплывающего окна. |
final ReadOnlyDoubleProperty |
anchorX |
Задает координату x точки привязки всплывающего окна на экране. |
final ReadOnlyDoubleProperty |
anchorY |
Задает координату y точки привязки всплывающего окна на экране. |
final BooleanProperty |
autoFix |
Эта переменная удобства указывает, следует ли при отображении всплывающего окна автоматически корректировать его положение, чтобы оно не оказалось за пределами экрана. |
final BooleanProperty |
autoHide |
Указывает, следует ли автоматически скрывать всплывающие окна. |
final BooleanProperty |
consumeAutoHidingEvents |
Указывает, следует ли потреблять событие, которое вызвало скрытие всплывающего окна. |
final BooleanProperty |
hideOnEscape |
Указывает, должно ли PopupWindow скрываться при нажатии необработанной клавиши Escape, когда всплывающее окно находится в фокусе. |
final ObjectProperty<EventHandler<Event>> |
onAutoHide |
Вызывается после выполнения autoHide. |
final ReadOnlyObjectProperty<Node> |
ownerNode |
Узел, который является владельцем этого всплывающего окна. |
final 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 enum |
PopupWindow.AnchorLocation |
Константы местоположения привязки для выбора точки привязки всплывающего окна. |
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
PopupWindow() |
Конструктор для вызова подклассами. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
final ObjectProperty<PopupWindow.AnchorLocation> |
anchorLocationProperty() |
Задает точку привязки всплывающего окна, которая используется при позиционировании всплывающего окна. |
final ReadOnlyDoubleProperty |
anchorXProperty() |
Задает координату x точки привязки всплывающего окна на экране. |
final ReadOnlyDoubleProperty |
anchorYProperty() |
Задает координату y точки привязки всплывающего окна на экране. |
final BooleanProperty |
autoFixProperty() |
Эта переменная удобства указывает, следует ли при отображении всплывающего окна автоматически корректировать его положение, чтобы оно не оказалось за пределами экрана. |
final BooleanProperty |
autoHideProperty() |
Указывает, следует ли автоматически скрывать всплывающие окна. |
final BooleanProperty |
consumeAutoHidingEventsProperty() |
Указывает, следует ли потреблять событие, которое вызвало скрытие всплывающего окна. |
final PopupWindow.AnchorLocation |
getAnchorLocation() |
Получает значение свойства anchorLocation. |
final double |
getAnchorX() |
Получает значение свойства anchorX. |
final double |
getAnchorY() |
Получает значение свойства anchorY. |
final boolean |
getConsumeAutoHidingEvents() |
Получает значение свойства consumeAutoHidingEvents. |
final EventHandler<Event> |
getOnAutoHide() |
Получает значение свойства onAutoHide. |
final Node |
getOwnerNode() |
Получает значение свойства ownerNode. |
final Window |
getOwnerWindow() |
Получает значение свойства ownerWindow. |
void |
hide() |
Скрыть это всплывающее окно и все его дочерние элементы |
final BooleanProperty |
hideOnEscapeProperty() |
Указывает, должно ли PopupWindow скрываться при нажатии необработанной клавиши Escape, когда всплывающее окно находится в фокусе. |
final boolean |
isAutoFix() |
Получает значение свойства autoFix. |
final boolean |
isAutoHide() |
Получает значение свойства autoHide. |
final boolean |
isHideOnEscape() |
Получает значение свойства hideOnEscape. |
final ObjectProperty<EventHandler<Event>> |
onAutoHideProperty() |
Вызывается после выполнения autoHide. |
final ReadOnlyObjectProperty<Node> |
ownerNodeProperty() |
Узел, который является владельцем этого всплывающего окна. |
final ReadOnlyObjectProperty<Window> |
ownerWindowProperty() |
Окно, которое является родителем этого всплывающего окна. |
final void |
setAnchorLocation |
Задает значение свойства anchorLocation. |
final void |
setAnchorX |
Задает значение свойства anchorX. |
final void |
setAnchorY |
Задает значение свойства anchorY. |
final void |
setAutoFix |
Задает значение свойства autoFix. |
final void |
setAutoHide |
Задает значение свойства autoHide. |
final void |
setConsumeAutoHidingEvents |
Задает значение свойства consumeAutoHidingEvents. |
final void |
setHideOnEscape |
Задает значение свойства hideOnEscape. |
final void |
setOnAutoHide |
Задает значение свойства onAutoHide. |
protected final void |
setScene |
Примечание для подклассов: сцена, используемая PopupWindow, очень конкретно управляется PopupWindow. |
void |
show |
Показывает всплывающее окно в указанном месте на экране. |
void |
show |
Показать всплывающее окно. |
void |
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
Подробные сведения о свойстве
ownerWindow
public final ReadOnlyObjectProperty<Window> ownerWindowProperty
- См. также:
ownerNode
public final ReadOnlyObjectProperty<Node> ownerNodeProperty
- См. также:
autoFix
public final BooleanProperty autoFixProperty
- Значение по умолчанию:
- true
- См. также:
autoHide
public final BooleanProperty autoHideProperty
Исключением является случай, когда узел-владелец задан с помощью show(javafx.scene.Node, double, double). Фокусировка узла-владельца не приведет к скрытию PopupWindow.
- Значение по умолчанию:
- false
- См. также:
onAutoHide
public final ObjectProperty<EventHandler<Event>> onAutoHideProperty
hideOnEscape
public final BooleanProperty hideOnEscapeProperty
- Значение по умолчанию:
- true
- См. также:
consumeAutoHidingEvents
public final BooleanProperty consumeAutoHidingEventsProperty
- Значение по умолчанию:
- true
- С:
- JavaFX 2.2
- См. также:
anchorX
public final ReadOnlyDoubleProperty anchorXProperty
anchorLocation установлено в WINDOW_TOP_LEFT или WINDOW_BOTTOM_LEFT, значения x и anchorX будут одинаковыми.- С:
- JavaFX 8.0
- См. также:
anchorY
public final ReadOnlyDoubleProperty anchorYProperty
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.- Описание свойства:
- Окно, являющееся родителем этого всплывающего окна. Все всплывающие окна должны иметь окно-владелец.
- Возвращает:
- значение свойства
ownerWindow - См. также:
ownerWindowProperty
public final ReadOnlyObjectProperty<Window> ownerWindowProperty()
- Возвращает:
- свойство
ownerWindow - См. также:
getOwnerNode
public final Node getOwnerNode()
ownerNode.- Описание свойства:
- Узел, являющийся владельцем этого всплывающего окна. Все всплывающие окна должны иметь окно-владелец, но не обязательно должны быть связаны с узлом-владельцем. Если у всплывающего окна с функцией автоскрытия есть узел-владелец, нажатие мыши внутри узла-владельца не приводит к скрытию всплывающего окна.
- Возвращает:
- значение свойства
ownerNode - См. также:
ownerNodeProperty
public final ReadOnlyObjectProperty<Node> ownerNodeProperty()
- Возвращает:
- свойство
ownerNode - См. также:
setScene
protected final void setScene(Scene scene)
- Переопределяет:
-
setSceneв классеWindow - Параметры:
-
scene- сцена, которая должна отображаться в этом окне - См. также:
setAutoFix
public final void setAutoFix(boolean value)
autoFix.- Описание свойства:
- Эта переменная-удобство указывает, нужно ли при отображении всплывающего окна автоматически корректировать его позицию, чтобы оно не выходило за пределы экрана.
- Значение по умолчанию:
- true
- Параметры:
-
value- значение для свойстваautoFix - См. также:
isAutoFix
public final boolean isAutoFix()
autoFix.- Описание свойства:
- Эта переменная-удобство указывает, нужно ли при отображении всплывающего окна автоматически корректировать его позицию, чтобы оно не выходило за пределы экрана.
- Значение по умолчанию:
- true
- Возвращает:
- значение свойства
autoFix - См. также:
autoFixProperty
public final BooleanProperty autoFixProperty()
- Значение по умолчанию:
- true
- Возвращает:
- свойство
autoFix - См. также:
setAutoHide
public final void setAutoHide(boolean value)
autoHide.- Описание свойства:
- Определяет, должны ли всплывающие окна автоматически скрываться. Если всплывающее окно теряет фокус, а autoHide имеет значение true, то оно будет автоматически скрыто.
Исключением является случай, когда узел владельца задан с помощью
show(javafx.scene.Node, double, double). Получение фокуса узлом владельца не приведет к скрытию PopupWindow. - Значение по умолчанию:
- false
- Параметры:
-
value- значение для свойстваautoHide - См. также:
isAutoHide
public final boolean isAutoHide()
autoHide.- Описание свойства:
- Определяет, должны ли всплывающие окна автоматически скрываться. Если всплывающее окно теряет фокус, а autoHide имеет значение true, то оно будет автоматически скрыто.
Исключением является случай, когда узел владельца задан с помощью
show(javafx.scene.Node, double, double). Получение фокуса узлом владельца не приведет к скрытию PopupWindow. - Значение по умолчанию:
- false
- Возвращает:
- значение свойства
autoHide - См. также:
autoHideProperty
public final BooleanProperty autoHideProperty()
Исключением является случай, когда узел владельца задан с помощью show(javafx.scene.Node, double, double). Получение фокуса узлом владельца не приведет к скрытию PopupWindow.
- Значение по умолчанию:
- false
- Возвращает:
- свойство
autoHide - См. также:
setOnAutoHide
public final void setOnAutoHide(EventHandler<Event> value)
onAutoHide.- Описание свойства:
- Вызывается после выполнения autoHide.
- Параметры:
-
value- значение для свойстваonAutoHide - См. также:
getOnAutoHide
public final EventHandler<Event> getOnAutoHide()
onAutoHide.- Описание свойства:
- Вызывается после выполнения autoHide.
- Возвращает:
- значение свойства
onAutoHide - См. также:
onAutoHideProperty
public final ObjectProperty<EventHandler<Event>> onAutoHideProperty()
- Возвращает:
- свойство
onAutoHide - См. также:
setHideOnEscape
public final void setHideOnEscape(boolean value)
hideOnEscape.- Описание свойства:
- Указывает, должно ли всплывающее окно скрываться при нажатии клавиши Escape, если оно имеет фокус.
- Значение по умолчанию:
- true
- Параметры:
-
value- значение для свойстваhideOnEscape - См. также:
isHideOnEscape
public final boolean isHideOnEscape()
hideOnEscape.- Описание свойства:
- Указывает, должно ли всплывающее окно скрываться при нажатии клавиши Escape, если оно имеет фокус.
- Значение по умолчанию:
- true
- Возвращает:
- значение свойства
hideOnEscape - См. также:
hideOnEscapeProperty
public final BooleanProperty hideOnEscapeProperty()
- Значение по умолчанию:
- true
- Возвращает:
- свойство
hideOnEscape - См. также:
setConsumeAutoHidingEvents
public final void setConsumeAutoHidingEvents(boolean value)
consumeAutoHidingEvents.- Описание свойства:
- Указывает, должен ли быть обработан тот событие, которое вызвало скрытие всплывающего окна. Обработка события предотвращает возникновение дополнительных реакций пользовательского интерфейса в окне-владельце всплывающего окна.
- Значение по умолчанию:
- true
- Параметры:
-
value- значение для свойстваconsumeAutoHidingEvents - С момента:
- JavaFX 2.2
- См. также:
getConsumeAutoHidingEvents
public final boolean getConsumeAutoHidingEvents()
consumeAutoHidingEvents.- Описание свойства:
- Указывает, должен ли быть обработан тот событие, которое вызвало скрытие всплывающего окна. Обработка события предотвращает возникновение дополнительных реакций пользовательского интерфейса в окне-владельце всплывающего окна.
- Значение по умолчанию:
- true
- Возвращает:
- значение свойства
consumeAutoHidingEvents - С момента:
- JavaFX 2.2
- См. также:
consumeAutoHidingEventsProperty
public final BooleanProperty consumeAutoHidingEventsProperty()
- Значение по умолчанию:
- true
- Возвращает:
- свойство
consumeAutoHidingEvents - С момента:
- JavaFX 2.2
- См. также:
show
public void show(Window owner)
- Параметры:
-
owner- Владелец всплывающего окна. Не должно быть null. - Исключения:
-
NullPointerException- если владелец равен null -
IllegalArgumentException- если заданное окно-владелец создаст цикл в иерархии окон
show
public void show(Node ownerNode, double anchorX, double anchorY)
anchorLocation) отображается по заданным anchorX и anchorY координатам. Всплывающее окно ассоциируется с указанным узлом владельца. Окно, содержащее узел владельца во время вызова, становится окном-владельцем отображенного всплывающего окна.
Обратите внимание, что при установке autoHide в значение true, щелчок мышью по узлу владельца не приведет к скрытию PopupWindow.
- Параметры:
-
ownerNode- Узел владельца всплывающего окна. Не должен быть null и должен быть связан с окном. -
anchorX- Позиция по оси X точки привязки всплывающего окна в координатах экрана -
anchorY- Позиция по оси Y точки привязки всплывающего окна в координатах экрана - Исключения:
-
NullPointerException- если ownerNode равен null -
IllegalArgumentException- если указанный узел владельца не связан с окном или если окно создаст цикл в иерархии окон
отобразить
public void show(Window ownerWindow, double anchorX, double anchorY)
anchorLocation) отображается по заданным anchorX и anchorY координатам.- Параметры:
-
ownerWindow- Владелец всплывающего окна. Не должно быть null. -
anchorX- Позиция по оси X точки привязки всплывающего окна в координатах экрана -
anchorY- Позиция по оси Y точки привязки всплывающего окна в координатах экрана - Исключения:
-
NullPointerException- если ownerWindow равно null -
IllegalArgumentException- если указанное окно-владелец создаст цикл в иерархии окон
скрыть
public void hide()
- Переопределяет:
-
hideв классеWindow
setAnchorX
public final void setAnchorX(double value)
anchorX.- Описание свойства:
- Указывает координату x точки привязки всплывающего окна на экране. Если
anchorLocationустановлено вWINDOW_TOP_LEFTилиWINDOW_BOTTOM_LEFTзначенияxиanchorXбудут идентичными. - Параметры:
-
value- значение для свойстваanchorX - С:
- JavaFX 8.0
- См. также:
getAnchorX
public final double getAnchorX()
anchorX.- Описание свойства:
- Указывает координату x точки привязки всплывающего окна на экране. Если
anchorLocationустановлено вWINDOW_TOP_LEFTилиWINDOW_BOTTOM_LEFTзначенияxиanchorXбудут идентичными. - Возвращает:
- значение свойства
anchorX - С:
- JavaFX 8.0
- См. также:
anchorXProperty
public final ReadOnlyDoubleProperty anchorXProperty()
anchorLocation установлено в WINDOW_TOP_LEFT или WINDOW_BOTTOM_LEFT значения x и anchorX будут идентичными.- Возвращает:
- свойство
anchorX - С:
- JavaFX 8.0
- См. также:
setAnchorY
public final void setAnchorY(double value)
anchorY.- Описание свойства:
- Указывает координату y точки привязки всплывающего окна на экране. Если
anchorLocationустановлено вWINDOW_TOP_LEFTилиWINDOW_TOP_RIGHTзначенияyиanchorYбудут идентичными. - Параметры:
-
value- значение для свойстваanchorY - С:
- JavaFX 8.0
- См. также:
getAnchorY
public final double getAnchorY()
anchorY.- Описание свойства:
- Указывает координату y точки привязки всплывающего окна на экране. Если
anchorLocationустановлено вWINDOW_TOP_LEFTилиWINDOW_TOP_RIGHTзначенияyиanchorYбудут идентичными. - Возвращает:
- значение свойства
anchorY - С:
- JavaFX 8.0
- См. также:
anchorYProperty
public final ReadOnlyDoubleProperty anchorYProperty()
anchorLocation установлено в WINDOW_TOP_LEFT или WINDOW_TOP_RIGHT значения y и anchorY будут идентичными.- Возвращает:
- свойство
anchorY - С:
- JavaFX 8.0
- См. также:
setAnchorLocation
public final void setAnchorLocation(PopupWindow.AnchorLocation value)
anchorLocation.- Описание свойства:
- Указывает точку привязки всплывающего окна, используемую при позиционировании всплывающего окна. Точка может быть установлена в угол окна всплывающего окна или угол его содержимого. В данном контексте углы содержимого выводятся из пределов макета узла корня всплывающего окна.
В общем случае изменение расположения точки привязки не изменяет текущую позицию окна. Вместо этого значения
anchorXиanchorYпересчитываются для соответствия новой точке привязки. - Параметры:
-
value- значение для свойстваanchorLocation - С:
- JavaFX 8.0
- См. также:
getAnchorLocation
public final PopupWindow.AnchorLocation getAnchorLocation()
anchorLocation.- Описание свойства:
- Указывает точку привязки всплывающего окна, используемую при позиционировании всплывающего окна. Точка может быть установлена в угол окна всплывающего окна или угол его содержимого. В данном контексте углы содержимого выводятся из пределов макета узла корня всплывающего окна.
В общем случае изменение расположения точки привязки не изменяет текущую позицию окна. Вместо этого значения
anchorXиanchorYпересчитываются для соответствия новой точке привязки. - Возвращает:
- значение свойства
anchorLocation - С:
- JavaFX 8.0
- См. также:
anchorLocationProperty
public final ObjectProperty<PopupWindow.AnchorLocation> anchorLocationProperty()
В общем случае изменение расположения точки привязки не изменяет текущую позицию окна. Вместо этого значения anchorX и anchorY пересчитываются для соответствия новой точке привязки.
- Возвращает:
- свойство
anchorLocation - С:
- 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.