Класс PopupWindow

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 инкапсулирует многие функции и поведение, характерные для всплывающих окон, такие как возможность закрытия при нажатии клавиши «Esc» или возможность скрытия всех дочерних всплывающих окон при скрытии данного окна. Эти возможности могут быть включены или выключены с помощью свойств.

С:: JavaFX 2.0

Краткое описание вложенных классов

Modifier and Type	Class	Description
`static enum`	`PopupWindow.AnchorLocation`	Константы расположения якоря для выбора точки привязки всплывающего окна.

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

Type	Свойство	Description
`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`	Указывает, следует ли скрывать всплывающее окно, когда нажата клавиша 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

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

Конструктор	Description
`PopupWindow()`	Конструктор для вызова подклассами.

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

Modifier and Type	Метод	Description
`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()`	Указывает, следует ли скрывать всплывающее окно, когда нажата клавиша 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(PopupWindow.AnchorLocation value)`	Устанавливает значение свойства `anchorLocation`.
`final void`	`setAnchorX(double value)`	Устанавливает значение свойства `anchorX`.
`final void`	`setAnchorY(double value)`	Устанавливает значение свойства `anchorY`.
`final void`	`setAutoFix(boolean value)`	Устанавливает значение свойства `autoFix`.
`final void`	`setAutoHide(boolean value)`	Устанавливает значение свойства `autoHide`.
`final void`	`setConsumeAutoHidingEvents(boolean value)`	Устанавливает значение свойства `consumeAutoHidingEvents`.
`final void`	`setHideOnEscape(boolean value)`	Устанавливает значение свойства `hideOnEscape`.
`final void`	`setOnAutoHide(EventHandler<Event> value)`	Устанавливает значение свойства `onAutoHide`.
`protected final void`	`setScene(Scene scene)`	Примечание для подклассов: сцена, используемая PopupWindow, очень специфически управляется PopupWindow.
`void`	`show(Node ownerNode, double anchorX, double anchorY)`	Показать всплывающее окно по указанным координатам на экране.
`void`	`show(Window owner)`	Показать всплывающее окно.
`void`	`show(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

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

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

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

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). При получении фокуса узлом-владельцем всплывающее окно не будет скрыто.

Значение по умолчанию:

false

См. также:

onAutoHide

public final ObjectProperty<EventHandler<Event>> onAutoHideProperty

Вызывается после автоматического скрытия.

См. также:

hideOnEscape

public final BooleanProperty hideOnEscapeProperty

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

Значение по умолчанию:

true

См. также:

consumeAutoHidingEvents

public final BooleanProperty consumeAutoHidingEventsProperty

Указывает, должна ли быть обработана операция, которая привела к скрытию всплывающего окна. Обработка события предотвращает срабатывание дополнительных реакций пользовательского интерфейса в окне-владельце всплывающего окна.

Значение по умолчанию:

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.

Описание свойства:

Возвращает:

значение свойства 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)

Примечание для подклассов: сцена, используемая PopupWindow, управлятся очень специфически. Данный метод переопределен для выброса UnsupportedOperationException. Вы не можете указать свою собственную сцену.

Переопределяет:

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.

Описание свойства:

Значение по умолчанию:

false

Возвращает:

значение свойства autoHide

См. также:

autoHideProperty

public final BooleanProperty autoHideProperty()

Значение по умолчанию:

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()

Вызывается после выполнения autoHide.

Возвращает:

свойство onAutoHide

См. также:

setHideOnEscape

public final void setHideOnEscape(boolean value)

Устанавливает значение свойства hideOnEscape.

Описание свойства:

Указывает, следует ли скрывать PopupWindow при нажатии клавиши Escape, если она не обработана, а всплывающее окно имеет фокус.

Значение по умолчанию:

true

Параметры:

value - значение для свойства hideOnEscape

См. также:

isHideOnEscape

public final boolean isHideOnEscape()

Получает значение свойства hideOnEscape.

Описание свойства:

Значение по умолчанию:

true

Возвращает:

значение свойства hideOnEscape

См. также:

hideOnEscapeProperty

public final BooleanProperty hideOnEscapeProperty()

Значение по умолчанию:

true

Возвращает:

свойство hideOnEscape

См. также:

setConsumeAutoHidingEvents

public final void setConsumeAutoHidingEvents(boolean value)

Устанавливает значение свойства consumeAutoHidingEvents.

Описание свойства:

Указывает, следует ли потреблять событие, вызвавшее скрытие всплывающего окна. Потребление события предотвращает срабатывание дополнительных UI-откликов в окне-владельце всплывающего окна.

Значение по умолчанию:

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 координатах.

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

Обратите внимание, что при установке autoHide в значение true, нажатие мышью на узел-владелец не будет скрывать окно всплывающего содержимого.

Parameters:: ownerNode - Узел-владелец всплывающего окна. Он не должен быть null и должен быть связан с окном.; anchorX - положение по оси x точки привязки всплывающего окна в координатах экрана; anchorY - положение по оси y точки привязки всплывающего окна в координатах экрана
Throws:: NullPointerException - если ownerNode равно null; IllegalArgumentException - если указанный узел-владелец не связан с окном или если окно создаст цикл в иерархии окон

show

public void show(Window ownerWindow, double anchorX, double anchorY)

Parameters:: ownerWindow - Владелец всплывающего окна. Не должен быть null.; anchorX - положение по оси x точки привязки всплывающего окна в координатах экрана; anchorY - положение по оси y точки привязки всплывающего окна в координатах экрана
Throws:: NullPointerException - если ownerWindow равно null; IllegalArgumentException - если указанное окно-владелец создаст цикл в иерархии окон

hide

public void hide()

Скрыть это всплывающее окно и все его дочерние элементы

Overrides:: hide в классе Window

setAnchorX

public final void setAnchorX(double value)

Устанавливает значение свойства anchorX.

Описание свойства:

Parameters:

value - значение для свойства anchorX

Since:

JavaFX 8.0

See Also:

getAnchorX

public final double getAnchorX()

Получает значение свойства anchorX.

Описание свойства:

Returns:

значение свойства anchorX

Since:

JavaFX 8.0

See Also:

anchorXProperty

public final ReadOnlyDoubleProperty anchorXProperty()

Returns:

свойство anchorX

Since:

JavaFX 8.0

See Also:

setAnchorY

public final void setAnchorY(double value)

Устанавливает значение свойства anchorY.

Описание свойства:

Parameters:

value - значение для свойства anchorY

Since:

JavaFX 8.0

See Also:

getAnchorY

public final double getAnchorY()

Получает значение свойства anchorY.

Описание свойства:

Returns:

значение свойства anchorY

Since:

JavaFX 8.0

See Also:

anchorYProperty

public final ReadOnlyDoubleProperty anchorYProperty()

Returns:

свойство anchorY

Since:

JavaFX 8.0

See Also:

setAnchorLocation

public final void setAnchorLocation(PopupWindow.AnchorLocation value)

Устанавливает значение свойства anchorLocation.

Описание свойства:

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

В общем случае изменение местоположения точки привязки не изменяет текущее положение окна. Вместо этого значения anchorX и anchorY пересчитываются для соответствия новой точке привязки.

Parameters:

value - значение для свойства anchorLocation

Since:

JavaFX 8.0

See Also:

getAnchorLocation

public final PopupWindow.AnchorLocation getAnchorLocation()

Получает значение свойства anchorLocation.

Описание свойства:

Returns:

значение свойства anchorLocation

Since:

JavaFX 8.0

See Also:

anchorLocationProperty

public final ObjectProperty<PopupWindow.AnchorLocation> anchorLocationProperty()

Returns:

свойство anchorLocation

Since:

JavaFX 8.0

See Also:

© 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.