Класс Window

java.lang.Object

javafx.stage.Window

Все реализованные интерфейсы:: EventTarget

Прямые известные подклассы:: PopupWindow, Stage

public class Window extends Object implements EventTarget

Окно верхнего уровня, в котором размещена сцена и с которым пользователь взаимодействует. Окно может быть Stage, PopupWindow или другим подобным окном верхнего уровня.

Объекты Window должны создаваться и изменяться в потоке JavaFX Application.

Поток JavaFX Application создается в рамках процесса запуска JavaFX runtime. См. класс Application и метод Platform.startup(Runnable) для получения дополнительной информации.

Некоторые Window свойства являются только для чтения, даже если у них есть соответствующие методы установки, потому что они могут быть изменены внешними компонентами платформы и, следовательно, не должны быть привязываемыми. Кроме того, эти свойства могут быть проигнорированы на некоторых платформах в зависимости от наличия диспетчера окон и его конфигурации. Например, диспетчер окон с размещением по мозаике может игнорировать свойства x и y или рассматривать их как подсказки, размещая окно по своему усмотрению.

С момента:: JavaFX 2.0

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

Тип	Свойство	Описание
`final ObjectProperty<EventDispatcher>`	`eventDispatcher`	Определяет диспетчер событий для этого узла.
`final ReadOnlyBooleanProperty`	`focused`	Указывает, имеет ли это `Window` фокус клавиатуры или ввода.
`final BooleanProperty`	`forceIntegerRenderScale`	Логическое свойство, которое управляет тем, устанавливаются ли только целые масштабы отрисовки по умолчанию системой при изменении связанного масштаба вывода.
`final ReadOnlyDoubleProperty`	`height`	Высота этого `Window`.
`final ObjectProperty<EventHandler<WindowEvent>>`	`onCloseRequest`	Вызывается при внешнем запросе на закрытие этого `Window`.
`final ObjectProperty<EventHandler<WindowEvent>>`	`onHidden`	Вызывается сразу после того, как окно было скрыто.
`final ObjectProperty<EventHandler<WindowEvent>>`	`onHiding`	Вызывается непосредственно перед скрытием окна.
`final ObjectProperty<EventHandler<WindowEvent>>`	`onShowing`	Вызывается непосредственно перед отображением окна.
`final ObjectProperty<EventHandler<WindowEvent>>`	`onShown`	Вызывается сразу после отображения окна.
`final DoubleProperty`	`opacity`	Определяет непрозрачность `Window` как значение от 0,0 до 1,0.
`final ReadOnlyDoubleProperty`	`outputScaleX`	Масштаб, который `Window` применит к горизонтальным координатам сцены на всех этапах рендеринга и композиции вывода на экран или другое целевое устройство.
`final ReadOnlyDoubleProperty`	`outputScaleY`	Масштаб, который `Window` применит к вертикальным координатам сцены на всех этапах рендеринга и композиции вывода на экран или другое целевое устройство.
`final DoubleProperty`	`renderScaleX`	Горизонтальный масштаб, который `Window` будет использовать при отрисовке своего `Scene` в буфер рендеринга.
`final DoubleProperty`	`renderScaleY`	Вертикальный масштаб, который `Window` будет использовать при отрисовке своего `Scene` в буфер рендеринга.
`final ReadOnlyObjectProperty<Scene>`	`scene`	`Scene` для отрисовки на этом `Window`.
`final ReadOnlyBooleanProperty`	`showing`	Указывает, отображается ли это `Window` (то есть, открыто ли оно на системе пользователя).
`final ReadOnlyDoubleProperty`	`width`	Ширина этого `Window`.
`final ReadOnlyDoubleProperty`	`x`	Горизонтальное положение этого `Window` на экране.
`final ReadOnlyDoubleProperty`	`y`	Вертикальное положение этого `Window` на экране.

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

Window()

Модификатор	Конструктор	Описание
`protected`	Конструктор для вызова подклассами.

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

Модификатор и тип	Метод	Описание
`final <T extends Event> void`	`addEventFilter(EventType<T> eventType, EventHandler<? super T> eventFilter)`	Регистрирует фильтр событий для этого объекта.
`final <T extends Event> void`	`addEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)`	Регистрирует обработчик событий для этого объекта.
`EventDispatchChain`	`buildEventDispatchChain(EventDispatchChain tail)`	Создаёт цепочку обработки событий для этого объекта.
`void`	`centerOnScreen()`	Устанавливает свойства x и y для этого окна так, чтобы оно было центрировано на текущем экране.
`final ObjectProperty<EventDispatcher>`	`eventDispatcherProperty()`	Устанавливает диспетчер событий для этого узла.
`final void`	`fireEvent(Event event)`	Вызывает указанное событие.
`final ReadOnlyBooleanProperty`	`focusedProperty()`	Указывает, имеет ли этот `Window` фокус клавиатуры или ввода.
`final BooleanProperty`	`forceIntegerRenderScaleProperty()`	Логическое свойство, которое управляет тем, устанавливаются ли только целочисленные масштабы рендеринга по умолчанию системой при изменении связанного масштаба вывода.
`final EventDispatcher`	`getEventDispatcher()`	Возвращает значение свойства `eventDispatcher`.
`final double`	`getHeight()`	Возвращает значение свойства `height`.
`final EventHandler<WindowEvent>`	`getOnCloseRequest()`	Возвращает значение свойства `onCloseRequest`.
`final EventHandler<WindowEvent>`	`getOnHidden()`	Возвращает значение свойства `onHidden`.
`final EventHandler<WindowEvent>`	`getOnHiding()`	Возвращает значение свойства `onHiding`.
`final EventHandler<WindowEvent>`	`getOnShowing()`	Возвращает значение свойства `onShowing`.
`final EventHandler<WindowEvent>`	`getOnShown()`	Возвращает значение свойства `onShown`.
`final double`	`getOpacity()`	Возвращает значение свойства `opacity`.
`final double`	`getOutputScaleX()`	Возвращает значение свойства `outputScaleX`.
`final double`	`getOutputScaleY()`	Возвращает значение свойства `outputScaleY`.
`final ObservableMap<Object,Object>`	`getProperties()`	Возвращает наблюдаемое отображение свойств этого узла, предназначенное в первую очередь для разработчиков приложений.
`final double`	`getRenderScaleX()`	Возвращает значение свойства `renderScaleX`.
`final double`	`getRenderScaleY()`	Возвращает значение свойства `renderScaleY`.
`final Scene`	`getScene()`	Возвращает значение свойства `scene`.
`Object`	`getUserData()`	Возвращает ранее заданное свойство Object или null, если такое свойство не было установлено с помощью метода `setUserData(java.lang.Object)`.
`final double`	`getWidth()`	Возвращает значение свойства `width`.
`static ObservableList<Window>`	`getWindows()`	Возвращает список, содержащий ссылку на текущие отображаемые окна JavaFX.
`final double`	`getX()`	Возвращает значение свойства `x`.
`final double`	`getY()`	Возвращает значение свойства `y`.
`boolean`	`hasProperties()`	Проверяет, есть ли у окна свойства.
`final ReadOnlyDoubleProperty`	`heightProperty()`	Высота этого `Window`.
`void`	`hide()`	Пытается скрыть это окно, установив видимость в false.
`final boolean`	`isFocused()`	Возвращает значение свойства `focused`.
`final boolean`	`isForceIntegerRenderScale()`	Возвращает значение свойства `forceIntegerRenderScale`.
`final boolean`	`isShowing()`	Возвращает значение свойства `showing`.
`final ObjectProperty<EventHandler<WindowEvent>>`	`onCloseRequestProperty()`	Вызывается при внешнем запросе на закрытие этого `Window`.
`final ObjectProperty<EventHandler<WindowEvent>>`	`onHiddenProperty()`	Вызывается сразу после того, как окно было скрыто.
`final ObjectProperty<EventHandler<WindowEvent>>`	`onHidingProperty()`	Вызывается непосредственно перед скрытием окна.
`final ObjectProperty<EventHandler<WindowEvent>>`	`onShowingProperty()`	Вызывается непосредственно перед отображением окна.
`final ObjectProperty<EventHandler<WindowEvent>>`	`onShownProperty()`	Вызывается сразу после отображения окна.
`final DoubleProperty`	`opacityProperty()`	Определяет непрозрачность `Window` как значение от 0,0 до 1,0.
`final ReadOnlyDoubleProperty`	`outputScaleXProperty()`	Масштаб, который `Window` будет применять к горизонтальным координатам сцены на всех этапах рендеринга и композиции вывода на экран или другое целевое устройство.
`final ReadOnlyDoubleProperty`	`outputScaleYProperty()`	Масштаб, который `Window` будет применять к вертикальным координатам сцены на всех этапах рендеринга и композиции вывода на экран или другое целевое устройство.
`final <T extends Event> void`	`removeEventFilter(EventType<T> eventType, EventHandler<? super T> eventFilter)`	Отменяет регистрацию ранее зарегистрированного фильтра событий из этого объекта.
`final <T extends Event> void`	`removeEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)`	Отменяет регистрацию ранее зарегистрированного обработчика событий из этого объекта.
`final DoubleProperty`	`renderScaleXProperty()`	Горизонтальный масштаб, который `Window` будет использовать при рендеринге своего `Scene` в буфер рендеринга.
`final DoubleProperty`	`renderScaleYProperty()`	Вертикальный масштаб, который `Window` будет использовать при рендеринге своего `Scene` в буфер рендеринга.
`final void`	`requestFocus()`	Запрашивает, чтобы это `Window` получило фокус ввода.
`final ReadOnlyObjectProperty<Scene>`	`sceneProperty()`	`Scene` для рендеринга на этом `Window`.
`final void`	`setEventDispatcher(EventDispatcher value)`	Устанавливает значение свойства `eventDispatcher`.
`protected final <T extends Event> void`	`setEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)`	Устанавливает обработчик для использования с этим типом события.
`final void`	`setForceIntegerRenderScale(boolean forced)`	Устанавливает значение свойства `forceIntegerRenderScale`.
`final void`	`setHeight(double value)`	Устанавливает значение свойства `height`.
`final void`	`setOnCloseRequest(EventHandler<WindowEvent> value)`	Устанавливает значение свойства `onCloseRequest`.
`final void`	`setOnHidden(EventHandler<WindowEvent> value)`	Устанавливает значение свойства `onHidden`.
`final void`	`setOnHiding(EventHandler<WindowEvent> value)`	Устанавливает значение свойства `onHiding`.
`final void`	`setOnShowing(EventHandler<WindowEvent> value)`	Устанавливает значение свойства `onShowing`.
`final void`	`setOnShown(EventHandler<WindowEvent> value)`	Устанавливает значение свойства `onShown`.
`final void`	`setOpacity(double value)`	Устанавливает значение свойства `opacity`.
`final void`	`setRenderScaleX(double scale)`	Устанавливает значение свойства `renderScaleX`.
`final void`	`setRenderScaleY(double scale)`	Устанавливает значение свойства `renderScaleY`.
`protected void`	`setScene(Scene value)`	Устанавливает значение свойства `scene`.
`void`	`setUserData(Object value)`	Удобный метод для установки одного свойства Object, которое можно получить в более позднее время.

`final void`	`setWidth(double value)`	Устанавливает значение свойства `width`.
`final void`	`setX(double value)`	Устанавливает значение свойства `x`.
`final void`	`setY(double value)`	Устанавливает значение свойства `y`.
`protected void`	`show()`	Попытка отобразить это окно, установив видимость в true
`final ReadOnlyBooleanProperty`	`showingProperty()`	Отображается ли это `Window` (то есть открыто ли оно на системе пользователя).
`void`	`sizeToScene()`	Устанавливает ширину и высоту этого окна в соответствии с размером содержимого сцены этого окна.
`final ReadOnlyDoubleProperty`	`widthProperty()`	Ширина этого `Window`.
`final ReadOnlyDoubleProperty`	`xProperty()`	Горизонтальное положение этого `Window` на экране.
`final ReadOnlyDoubleProperty`	`yProperty()`	Вертикальное положение этого `Window` на экране.

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

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

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

outputScaleX

public final ReadOnlyDoubleProperty outputScaleXProperty

Масштаб, который Window применяет к горизонтальным координатам сцены на всех этапах рендеринга и композиции вывода на экран или другое целевое устройство. Это свойство обновляется асинхронно системой в разное время, включая:

Создание окна
В какой-то момент при перемещении окна в новое Screen, что может произойти до или после обновления свойства Screen.
В ответ на изменение пользовательских предпочтений масштабирования вывода.

С:

См. также:

outputScaleY

public final ReadOnlyDoubleProperty outputScaleYProperty

Масштаб, который Window применяет к вертикальным координатам сцены на всех этапах рендеринга и композиции вывода на экран или другое целевое устройство. Это свойство обновляется асинхронно системой в разное время, включая:

Создание окна
В какой-то момент при перемещении окна в новое Screen, что может произойти до или после обновления свойства Screen.
В ответ на изменение пользовательских предпочтений масштабирования вывода.

С:

См. также:

forceIntegerRenderScale

public final BooleanProperty forceIntegerRenderScaleProperty

Свойство типа Boolean, которое управляет тем, устанавливаются ли системой по умолчанию только целочисленные масштабы рендеринга при изменении связанного масштаба вывода. Свойства renderScale будут обновляться напрямую и одновременно с любыми изменениями связанных свойств outputScale, но значения могут быть переопределены последующими вызовами методов установщиков setRenderScale или с помощью соответствующей привязки. Это свойство не предотвратит установку нецелочисленных масштабов напрямую с помощью объекта свойства renderScale или удобного метода установки.

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

false

С:

См. также:

renderScaleX

public final DoubleProperty renderScaleXProperty

Горизонтальный масштаб, который Window будет использовать при рендеринге своего Scene в буфер рендеринга. Это свойство автоматически обновляется всякий раз, когда происходит изменение свойства outputScaleX, и может быть переопределено путём вызова setRenderScaleX() в ответ на прослушиватель свойства outputScaleX или путём соответствующей привязки.

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

outputScaleX

С:

См. также:

renderScaleY

public final DoubleProperty renderScaleYProperty

Вертикальный масштаб, который Window будет использовать при рендеринге своего Scene в буфер рендеринга. Это свойство автоматически обновляется всякий раз, когда происходит изменение свойства outputScaleY, и может быть переопределено путём вызова setRenderScaleY() в ответ на прослушиватель свойства outputScaleY или путём соответствующей привязки.

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

outputScaleY

С:

См. также:

x

public final ReadOnlyDoubleProperty xProperty

Горизонтальное положение этого Window на экране. Изменение этого атрибута переместит Window по горизонтали. Если это Window является экземпляром Stage, изменение этого атрибута не повлияет визуально на Window, пока fullScreen равно true, но будет учтено Window, когда fullScreen станет false.

Это свойство является только для чтения, потому что его можно изменить извне с помощью базовой платформы. Кроме того, установка этого свойства может быть проигнорирована на некоторых платформах.

См. также:

y

public final ReadOnlyDoubleProperty yProperty

Вертикальное положение этого Window на экране. Изменение этого атрибута переместит Window по вертикали. Если это Window является экземпляром Stage, изменение этого атрибута не повлияет визуально на Window, пока fullScreen равно true, но будет учтено Window, когда fullScreen станет false.

См. также:

width

public final ReadOnlyDoubleProperty widthProperty

Ширина этого Window. Изменение этого атрибута сузит или расширит ширину Window. Это значение включает все декорации, которые могут быть добавлены операционной системой, такие как маркеры изменения размера. Типичные приложения устанавливают ширину Scene вместо этого. Это окно будет брать свою ширину из сцены, если она никогда не была установлена приложением. Изменение размера окна пользователем не считается установкой ширины приложением. Если это Window является экземпляром Stage, изменение этого атрибута не повлияет визуально на Window, пока fullScreen равно true, но будет учтено Window, когда fullScreen станет false.

См. также:

height

public final ReadOnlyDoubleProperty heightProperty

Высота этого Window. Изменение этого атрибута уменьшит или увеличит высоту Window. Это значение включает все декорации, которые могут быть добавлены операционной системой, такие как строка заголовка. Типичные приложения устанавливают высоту Scene вместо этого. Это окно будет брать свою высоту из сцены, если она никогда не была установлена приложением. Изменение размера окна пользователем не считается установкой высоты приложением. Если это Window является экземпляром Stage, изменение этого атрибута не повлияет визуально на Window, пока fullScreen равно true, но будет учтено Window, когда fullScreen станет false.

См. также:

focused

public final ReadOnlyBooleanProperty focusedProperty

Установлено ли у этого Window фокусное состояние клавиатуры или ввода.

См. также:

сцена

public final ReadOnlyObjectProperty<Scene> sceneProperty

Scene, которая должна быть отображена на этой Window. Одновременно на Window может быть только одна Scene, и Scene может быть только в одной Window. Установка Scene в другую Window приведет к тому, что старая Window потеряет ссылку до того, как новая получит её. Вы можете обменять Scene на Window в любое время, даже если это экземпляр Stage и с fullScreen установленным на true.

Если ширина или высота этой Window никогда не были заданы приложением, установка сцены заставит эту Window взять ширину или высоту из этой сцены. Изменение размера этой Window пользователем не считается установкой ширины или высоты приложением.

Если эта свойство устанавливается на потоке, отличном от потока JavaFX Application Thread, будет выброшено исключение IllegalStateException.

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

null

См. также:

непрозрачность

public final DoubleProperty opacityProperty

Определяет непрозрачность Window как значение от 0,0 до 1,0. Непрозрачность распространяется на Window, её Decoration и её содержимое Scene. На платформах JavaFX, которые не поддерживают непрозрачность, присвоение значения этой переменной не будет заметно отличаться. Window с непрозрачностью 0% полностью прозрачная. Обычно, Window с непрозрачностью 0% не будет получать какие-либо события мыши.

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

1,0

См. также:

запрос на закрытие

public final ObjectProperty<EventHandler<WindowEvent>> onCloseRequestProperty

Вызывается при внешнем запросе на закрытие этой Window. Установленный обработчик событий может предотвратить закрытие окна, обработв полученное событие.

См. также:

при отображении

public final ObjectProperty<EventHandler<WindowEvent>> onShowingProperty

Вызывается непосредственно перед отображением окна.

См. также:

после отображения

public final ObjectProperty<EventHandler<WindowEvent>> onShownProperty

Вызывается непосредственно после отображения окна.

См. также:

при скрытии

public final ObjectProperty<EventHandler<WindowEvent>> onHidingProperty

Вызывается непосредственно перед скрытием окна.

См. также:

после скрытия

public final ObjectProperty<EventHandler<WindowEvent>> onHiddenProperty

Вызывается непосредственно после скрытия окна. Когда Window скрывается, этот обработчик событий вызывается, позволяя разработчику очистить ресурсы или выполнить другие задачи при закрытии Window.

См. также:

отображение

public final ReadOnlyBooleanProperty showingProperty

Определяет, отображается ли это Window (то есть открыто на системе пользователя). Окно может быть "отображено", но пользователь может его не видеть, если оно расположено за другим окном или вне монитора.

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

false

См. также:

диспетчер событий

public final ObjectProperty<EventDispatcher> eventDispatcherProperty

Указывает диспетчер событий для этого узла. По умолчанию диспетчер событий отправляет полученные события зарегистрированным обработчикам событий и фильтрам. При замене значения новым EventDispatcher новый диспетчер должен передавать события заменённому диспетчеру, чтобы сохранить поведение обработки событий по умолчанию узла.

См. также:

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

Window

protected Window()

Конструктор для вызова подклассами.

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

getWindows

public static ObservableList<Window> getWindows()

Возвращает список, содержащий ссылку на текущие отображаемые окна JavaFX. Список неизменяемый — попытка его изменить приведет к исключению UnsupportedOperationException во время выполнения.

Возвращает:: Список, содержащий все отображаемые окна.
С момента:: 9

sizeToScene

public void sizeToScene()

Устанавливает ширину и высоту этого окна в соответствии с размером содержимого сцены этого окна.

Этот запрос может быть проигнорирован, если окно не имеет права на это, например, Stage может быть maximized или в fullScreen и поэтому не разрешает этот запрос. В этом случае этот запрос запоминается и повторно применяется позже, когда это разрешено.

centerOnScreen

public void centerOnScreen()

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

getOutputScaleX

public final double getOutputScaleX()

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

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

Масштаб, который Window будет применять к горизонтальным координатам сцены на всех этапах рендеринга и композиции вывода на экран или другое целевое устройство. Это свойство обновляется асинхронно системой в разное время, включая:

Создание окна
В какой-то момент во время перемещения окна на новый Screen, что может быть до или после обновления свойства Screen.
В ответ на изменение пользовательских предпочтений масштабирования вывода.

Возвращает:

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

С момента:

См. также:

outputScaleXProperty

public final ReadOnlyDoubleProperty outputScaleXProperty()

Создание окна
В какой-то момент во время перемещения окна на новый Screen, что может быть до или после обновления свойства Screen.
В ответ на изменение пользовательских предпочтений масштабирования вывода.

Возвращает:

свойство outputScaleX

С момента:

См. также:

getOutputScaleY

public final double getOutputScaleY()

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

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

Масштаб, который Window будет применять к вертикальным координатам сцены на всех этапах рендеринга и компоновки вывода на экран или другое целевое устройство. Это свойство асинхронно обновляется системой в разное время, в том числе:

Создание окна
В какой-то момент при перемещении окна в новый Screen, что может быть до или после обновления свойства Screen.
В ответ на изменение пользовательских настроек масштабирования вывода.

Возвращает:

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

С:

См. также:

outputScaleYProperty

public final ReadOnlyDoubleProperty outputScaleYProperty()

Создание окна
В какой-то момент при перемещении окна в новый Screen, что может быть до или после обновления свойства Screen.
В ответ на изменение пользовательских настроек масштабирования вывода.

Возвращает:

свойство outputScaleY

С:

См. также:

setForceIntegerRenderScale

public final void setForceIntegerRenderScale(boolean forced)

Задает значение свойства forceIntegerRenderScale.

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

Логическое свойство, которое определяет, будут ли по умолчанию системой устанавливаться только целочисленные масштабы рендеринга при изменении связанного масштаба вывода. Свойства renderScale будут обновляться напрямую и одновременно с любыми изменениями в связанных свойствах outputScale, но значения могут быть переопределены последующими вызовами методов задания setRenderScale или посредством соответствующего использования привязки. Это свойство не предотвратит установку нецелочисленных масштабов напрямую с использованием объекта свойства renderScale или удобного метода задания.

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

false

Параметры:

forced - значение для свойства forceIntegerRenderScale

С:

См. также:

isForceIntegerRenderScale

public final boolean isForceIntegerRenderScale()

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

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

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

false

Возвращает:

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

С:

См. также:

forceIntegerRenderScaleProperty

public final BooleanProperty forceIntegerRenderScaleProperty()

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

false

Возвращает:

свойство forceIntegerRenderScale

С:

См. также:

setRenderScaleX

public final void setRenderScaleX(double scale)

Задает значение свойства renderScaleX.

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

Горизонтальный масштаб, который Window будет использовать при рендеринге своих Scene в буфер рендеринга. Это свойство автоматически обновляется при каждом изменении свойства outputScaleX и может быть переопределено либо вызовом setRenderScaleX() в ответ на слушатель свойства outputScaleX, либо путем его соответствующей привязки.

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

outputScaleX

Параметры:

scale - значение для свойства renderScaleX

С:

См. также:

getRenderScaleX

public final double getRenderScaleX()

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

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

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

outputScaleX

Возвращает:

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

С:

См. также:

renderScaleXProperty

public final DoubleProperty renderScaleXProperty()

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

outputScaleX

Возвращает:

свойство renderScaleX

С:

См. также:

setRenderScaleY

public final void setRenderScaleY(double scale)

Задает значение свойства renderScaleY.

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

Вертикальный масштаб, который Window будет использовать при рендеринге своих Scene в буфер рендеринга. Это свойство автоматически обновляется при каждом изменении свойства outputScaleY и может быть переопределено либо вызовом setRenderScaleY() в ответ на слушатель свойства outputScaleY, либо путем его соответствующей привязки.

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

outputScaleY

Параметры:

scale - значение для свойства renderScaleY

С:

См. также:

getRenderScaleY

public final double getRenderScaleY()

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

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

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

outputScaleY

Возвращает:

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

С:

См. также:

renderScaleYProperty

public final DoubleProperty renderScaleYProperty()

Вертикальное масштабирование, которое Window будет использовать при отрисовке своего Scene в буфер отрисовки. Этот свойство автоматически обновляется всякий раз, когда происходит изменение свойства outputScaleY, и его можно переопределить, вызвав setRenderScaleY() в ответ на прослушивание события изменения свойства outputScaleY или связав его соответствующим образом.

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

outputScaleY

Возвращает:

свойство renderScaleY

С:

См. также:

setX

public final void setX(double value)

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

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

Горизонтальное положение этого Window на экране. Изменение этого атрибута переместит Window по горизонтали. Если этот Window является экземпляром Stage, изменение этого атрибута не повлияет визуально на Window, пока fullScreen равно true, но будет учтено Window, как только fullScreen станет false.

Это свойство является только для чтения, так как его можно изменить внешним образом посредством базовой платформы. Кроме того, установка этого свойства может быть проигнорирована на некоторых платформах.

Параметры:

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

См. также:

getX

public final double getX()

Возвращает значение свойства x.

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

Возвращает:

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

См. также:

xProperty

public final ReadOnlyDoubleProperty xProperty()

Возвращает:

свойство x

См. также:

setY

public final void setY(double value)

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

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

Вертикальное положение этого Window на экране. Изменение этого атрибута переместит Window по вертикали. Если этот Window является экземпляром Stage, изменение этого атрибута не повлияет визуально на Window, пока fullScreen равно true, но будет учтено Window, как только fullScreen станет false.

Параметры:

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

См. также:

getY

public final double getY()

Возвращает значение свойства y.

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

Возвращает:

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

См. также:

yProperty

public final ReadOnlyDoubleProperty yProperty()

Возвращает:

свойство y

См. также:

setWidth

public final void setWidth(double value)

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

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

Ширина этого Window. Изменение этого атрибута сузит или расширит ширину Window. Это значение включает все декорации, которые могут быть добавлены операционной системой, такие как маркеры изменения размера. Обычно приложения устанавливают ширину Scene вместо этого. Этот Window получит свою ширину из сцены, если она никогда не была установлена приложением. Изменение размера окна пользователем не считается установкой ширины приложением. Если этот Window является экземпляром Stage, изменение этого атрибута не повлияет визуально на Window, пока fullScreen равно true, но будет учтено Window, как только fullScreen станет false.

Параметры:

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

См. также:

getWidth

public final double getWidth()

Возвращает значение свойства width.

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

Ширина этого Window. Изменение этого атрибута сузит или расширит ширину Window. Это значение включает все декорации, которые могут быть добавлены операционной системой, такие как маркеры изменения размера. Обычно приложения устанавливают ширину Scene вместо этого. Этот Window получит свою ширину из сцены, если она никогда не была установлена приложением. Изменение размера окна пользователем не считается установкой ширины приложением. Если этот Window является экземпляром Stage, изменение этого атрибута не повлияет визуально на Window, пока fullScreen равно true, но будет учтено Window, как только fullScreen станет false.

Возвращает:

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

См. также:

widthProperty

public final ReadOnlyDoubleProperty widthProperty()

Ширина этого Window. Изменение этого атрибута сузит или расширит ширину Window. Это значение включает все декорации, которые могут быть добавлены операционной системой, такие как маркеры изменения размера рамки. Типичные приложения устанавливают ширину Scene вместо этого. Это окно будет брать свою ширину из сцены, если она никогда не была установлена приложением. Изменение размера окна пользователем не считается установкой ширины приложением. Если это Window является экземпляром Stage, изменение этого атрибута не повлияет визуально на Window, пока fullScreen истинно, но будет учтено Window, как только fullScreen станет ложным.

Это свойство является только для чтения, так как его можно изменить внешне с помощью базовой платформы. Кроме того, установка этого свойства может быть проигнорирована на некоторых платформах.

Возвращает:

свойство width

См. также:

setHeight

public final void setHeight(double value)

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

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

Высота этого Window. Изменение этого атрибута уменьшит или увеличит высоту Window. Это значение включает все декорации, которые могут быть добавлены операционной системой, такие как строка заголовка. Типичные приложения устанавливают высоту Scene вместо этого. Это окно будет брать свою высоту со сцены, если она никогда не была установлена приложением. Изменение размера этого окна пользователем не считается установкой высоты приложением. Если это Window является экземпляром Stage, изменение этого атрибута не повлияет визуально на Window, пока fullScreen истинно, но будет учтено Window, как только fullScreen станет ложным.

Параметры:

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

См. также:

getHeight

public final double getHeight()

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

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

Высота этого Window. Изменение этого атрибута уменьшит или увеличит высоту Window. Это значение включает все декорации, которые могут быть добавлены операционной системой, такие как строка заголовка. Типичные приложения устанавливают высоту Scene вместо этого. Это окно будет брать свою высоту со сцены, если она никогда не была установлена приложением. Изменение размера этого окна пользователем не считается установкой высоты приложением. Если это Window является экземпляром Stage, изменение этого атрибута не повлияет визуально на Window, пока fullScreen истинно, но будет учтено Window, как только fullScreen станет ложным.

Возвращает:

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

См. также:

heightProperty

public final ReadOnlyDoubleProperty heightProperty()

Высота этого Window. Изменение этого атрибута уменьшит или увеличит высоту Window. Это значение включает все декорации, которые могут быть добавлены операционной системой, такие как строка заголовка. Типичные приложения устанавливают высоту Scene вместо этого. Это окно будет брать свою высоту со сцены, если она никогда не была установлена приложением. Изменение размера этого окна пользователем не считается установкой высоты приложением. Если это Window является экземпляром Stage, изменение этого атрибута не повлияет визуально на Window, пока fullScreen истинно, но будет учтено Window, как только fullScreen станет ложным.

Возвращает:

свойство height

См. также:

requestFocus

public final void requestFocus()

Запрашивает, чтобы это Window получило фокус ввода.

isFocused

public final boolean isFocused()

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

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

Установлен ли для этого Window фокус клавиатуры или ввода.

Возвращает:

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

См. также:

focusedProperty

public final ReadOnlyBooleanProperty focusedProperty()

Установлен ли для этого Window фокус клавиатуры или ввода.

Возвращает:

свойство focused

См. также:

getProperties

public final ObservableMap<Object,Object> getProperties()

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

Возвращает:: наблюдаемую карту свойств этого узла, предназначенную в основном для разработчиков приложений
С:: JavaFX 8u40

hasProperties

public boolean hasProperties()

Проверяет, имеет ли окно свойства.

Возвращает:: истинно, если узел имеет свойства.
С:: JavaFX 8u40

setUserData

public void setUserData(Object value)

Удобный метод для установки единственного свойства Object, которое можно получить впоследствии. Функционально эквивалентно вызову метода getProperties().put(Object key, Object value). Его можно получить позже, вызвав getUserData().

Параметры:: value - значение для хранения - его можно получить позже, вызвав getUserData().
С:: JavaFX 8u40

getUserData

public Object getUserData()

Возвращает ранее установленное свойство Object или null, если такое свойство не было установлено с помощью метода setUserData(java.lang.Object).

Возвращает:: Объект, который был ранее установлен, или null, если свойство не было установлено или было установлено значение null.
С:: JavaFX 8u40

setScene

protected void setScene(Scene value)

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

Scene для отображения на этом Window. Одновременно на Window может находиться только одна Scene, и Scene может находиться только на одной Window. Установка Scene на другое Window приведет к тому, что старая Window потеряет ссылку, прежде чем новая ее получит. Вы можете менять Scene на Window в любое время, даже если это экземпляр Stage и fullScreen установлено в значение true.

Если ширина или высота этого Window никогда не были установлены приложением, установка сцены приведет к тому, что это Window возьмет свою ширину или высоту из этой сцены. Изменение размера этого Window пользователем не считается установкой ширины или высоты приложением.

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

null

Параметры:

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

Исключения:

IllegalStateException - если это свойство установлено на потоке, отличном от потока JavaFX Application Thread.

См. также:

getScene

public final Scene getScene()

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

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

Scene, который должен быть отрисован на этом Window. Одновременно на Window может быть только один Scene, и Scene может находиться только на одном Window. Установка Scene на другом Window приведёт к потере ссылки на старый Window перед тем, как новый получит её. Вы можете менять Scene на Window в любое время, даже если это экземпляр Stage и fullScreen установлено в true.

Если ширина или высота этого Window никогда не устанавливались приложением, установка сцены заставит это Window взять свою ширину или высоту из этой сцены. Изменение размера этого Window пользователем не считается установкой ширины или высоты приложением.

Если это свойство устанавливается на потоке, отличном от потока приложения JavaFX, будет брошено исключение IllegalStateException.

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

null

Возвращает:

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

См. также:

sceneProperty

public final ReadOnlyObjectProperty<Scene> sceneProperty()

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

null

Возвращает:

свойство scene

См. также:

setOpacity

public final void setOpacity(double value)

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

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

Определяет непрозрачность Window как значение между 0,0 и 1,0. Непрозрачность отражается на Window, его Decoration и содержимом Scene. На платформах JavaFX, которые не поддерживают непрозрачность, присвоение значения этой переменной не будет заметно. Window с непрозрачностью 0% полностью прозрачен. Обычно Window с непрозрачностью 0% не получает никаких событий мыши.

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

1.0

Параметры:

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

См. также:

getOpacity

public final double getOpacity()

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

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

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

1.0

Возвращает:

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

См. также:

opacityProperty

public final DoubleProperty opacityProperty()

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

1.0

Возвращает:

свойство opacity

См. также:

setOnCloseRequest

public final void setOnCloseRequest(EventHandler<WindowEvent> value)

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

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

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

Параметры:

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

См. также:

getOnCloseRequest

public final EventHandler<WindowEvent> getOnCloseRequest()

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

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

Возвращает:

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

См. также:

onCloseRequestProperty

public final ObjectProperty<EventHandler<WindowEvent>> onCloseRequestProperty()

Возвращает:

свойство onCloseRequest

См. также:

setOnShowing

public final void setOnShowing(EventHandler<WindowEvent> value)

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

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

Вызывается непосредственно перед отображением окна.

Параметры:

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

См. также:

getOnShowing

public final EventHandler<WindowEvent> getOnShowing()

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

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

Вызывается непосредственно перед отображением окна.

Возвращает:

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

См. также:

onShowingProperty

public final ObjectProperty<EventHandler<WindowEvent>> onShowingProperty()

Вызывается непосредственно перед отображением окна.

Возвращает:

свойство onShowing

См. также:

setOnShown

public final void setOnShown(EventHandler<WindowEvent> value)

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

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

Вызывается сразу после отображения окна.

Параметры:

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

См. также:

getOnShown

public final EventHandler<WindowEvent> getOnShown()

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

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

Вызывается сразу после отображения окна.

Возвращает:

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

См. также:

onShownProperty

public final ObjectProperty<EventHandler<WindowEvent>> onShownProperty()

Вызывается сразу после отображения окна.

Возвращает:

свойство onShown

См. также:

setOnHiding

public final void setOnHiding(EventHandler<WindowEvent> value)

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

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

Вызывается непосредственно перед скрытием окна.

Параметры:

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

См. также:

getOnHiding

public final EventHandler<WindowEvent> getOnHiding()

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

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

Вызывается непосредственно перед скрытием окна.

Возвращает:

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

См. также:

onHidingProperty

public final ObjectProperty<EventHandler<WindowEvent>> onHidingProperty()

Вызывается непосредственно перед скрытием окна.

Возвращает:

свойство onHiding

См. также:

setOnHidden

public final void setOnHidden(EventHandler<WindowEvent> value)

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

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

Вызывается сразу после скрытия окна. Когда окно Window скрывается, этот обработчик событий вызывается, позволяя разработчику очистить ресурсы или выполнить другие задачи при закрытии окна Window.

Параметры:

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

См. также:

getOnHidden

public final EventHandler<WindowEvent> getOnHidden()

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

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

Возвращает:

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

См. также:

onHiddenProperty

public final ObjectProperty<EventHandler<WindowEvent>> onHiddenProperty()

Возвращает:

свойство onHidden

См. также:

isShowing

public final boolean isShowing()

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

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

Определяет, отображается ли это Window (то есть, открыто ли оно на системе пользователя). Окно может быть "отображено", но пользователь может не видеть его, так как окно может быть расположено за другим окном или за пределами монитора.

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

false

Возвращает:

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

См. также:

showingProperty

public final ReadOnlyBooleanProperty showingProperty()

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

false

Возвращает:

свойство showing

См. также:

show

protected void show()

Попытка отобразить это окно, установив видимость в true

Исключения:: IllegalStateException - если этот метод вызывается в потоке, отличном от потока JavaFX Application.

hide

public void hide()

Попытка скрыть это окно, установив видимость в false.

Исключения:: IllegalStateException - если этот метод вызывается в потоке, отличном от потока JavaFX Application.

setEventDispatcher

public final void setEventDispatcher(EventDispatcher value)

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

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

Указывает диспетчер событий для этого узла. Диспетчер событий по умолчанию отправляет полученные события зарегистрированным обработчикам событий и фильтрам. При замене значения на новый EventDispatcher, новый диспетчер должен пересылать события заменённому диспетчеру, чтобы сохранить стандартное поведение обработки событий узла.

Параметры:

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

См. также:

getEventDispatcher

public final EventDispatcher getEventDispatcher()

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

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

Возвращает:

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

См. также:

eventDispatcherProperty

public final ObjectProperty<EventDispatcher> eventDispatcherProperty()

Возвращает:

свойство eventDispatcher

См. также:

addEventHandler

public final <T extends Event> void addEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)

Описание скопировано из интерфейса: EventTarget

Регистрирует обработчик событий для этого целевого объекта.

Обработчик вызывается, когда целевой объект получает Event указанного типа во время фазы распространения события.

Спецификация:: addEventHandler в интерфейсе EventTarget
Параметры типа:: T - класс события обработчика
Параметры:: eventType - тип событий, получаемых обработчиком; eventHandler - обработчик событий

removeEventHandler

public final <T extends Event> void removeEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)

Описание скопировано из интерфейса: EventTarget

Удаляет ранее зарегистрированный обработчик событий из этого объекта.

Поскольку можно зарегистрировать один экземпляр EventHandler для разных типов событий, вызывающий метод должен указать тип события, из которого необходимо удалить обработчик.

Specified by:: removeEventHandler в интерфейсе EventTarget
Type Parameters:: T - класс события обработчика
Parameters:: eventType - тип события, из которого необходимо удалить обработчик; eventHandler - обработчик событий

addEventFilter

public final <T extends Event> void addEventFilter(EventType<T> eventType, EventHandler<? super T> eventFilter)

Описание скопировано из интерфейса: EventTarget

Регистрирует фильтр событий для этого объекта.

Фильтр вызывается, когда объект получает Event указанного типа во время фазы захвата доставки события.

Specified by:: addEventFilter в интерфейсе EventTarget
Type Parameters:: T - класс события фильтра
Parameters:: eventType - тип событий, получаемых фильтром; eventFilter - фильтр событий

removeEventFilter

public final <T extends Event> void removeEventFilter(EventType<T> eventType, EventHandler<? super T> eventFilter)

Описание скопировано из интерфейса: EventTarget

Удаляет ранее зарегистрированный фильтр событий из этого объекта.

Поскольку можно зарегистрировать один экземпляр EventHandler для разных типов событий, вызывающий метод должен указать тип события, из которого необходимо удалить фильтр.

Specified by:: removeEventFilter в интерфейсе EventTarget
Type Parameters:: T - класс события фильтра
Parameters:: eventType - тип события, из которого необходимо удалить фильтр; eventFilter - фильтр событий

setEventHandler

protected final <T extends Event> void setEventHandler(EventType<T> eventType, EventHandler<? super T> eventHandler)

Устанавливает обработчик для этого типа события. Одновременно может быть указан только один такой обработчик. Этот обработчик гарантированно вызывается первым. Используется для регистрации пользовательских обработчиков событий onFoo.

Type Parameters:: T - конкретный класс события обработчика
Parameters:: eventType - тип события, ассоциируемый с данным eventHandler; eventHandler - обработчик для регистрации или null для отмены регистрации
Throws:: NullPointerException - если тип события равен null

fireEvent

public final void fireEvent(Event event)

Вызывает указанное событие.

Этот метод должен вызываться в потоке FX пользовательского интерфейса.

Parameters:: event - событие для вызова

buildEventDispatchChain

public EventDispatchChain buildEventDispatchChain(EventDispatchChain tail)

Описание скопировано из интерфейса: EventTarget

Создаёт цепочку обработки событий для данного объекта. Цепочка обработки событий содержит обработчики событий, которые могут быть заинтересованы в обработке событий, направленных на этот EventTarget. Этот целевой объект события не добавляется в цепочку автоматически, поэтому, если он хочет обрабатывать события, ему необходимо добавить EventDispatcher для себя в цепочку.

В случае, если целевой объект события является частью иерархии, цепочка для него обычно строится из обработчиков событий, собранных от корня иерархии к целевому объекту события.

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

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

Specified by:: buildEventDispatchChain в интерфейсе EventTarget
Parameters:: tail - начальная цепочка, из которой нужно построить
Returns:: результирующая цепочка обработки событий для этого объекта

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