Spec-Zone.ru › OpenJavaFX 21

Класс Stage

java.lang.Object
javafx.stage.Window
javafx.stage.Stage
Все реализованные интерфейсы:
EventTarget
public class Stage extends Window
Класс JavaFX Stage — это контейнер верхнего уровня JavaFX. Основной объект Stage создаётся платформой. Дополнительные объекты Stage могут быть созданы приложением.

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

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

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

Стиль

Stage имеет один из следующих стилей:

  • StageStyle.DECORATED — Stage с тёмно-белым фоном и декорациями платформы.
  • StageStyle.UNDECORATED — Stage с тёмно-белым фоном и без декораций.
  • StageStyle.TRANSPARENT — Stage с прозрачным фоном и без декораций.
  • StageStyle.UTILITY — Stage с тёмно-белым фоном и минимальными декорациями платформы.

Стиль должен быть инициализирован до того, как Stage станет видимым.

На некоторых платформах декорации могут отсутствовать. Например, на некоторых мобильных или встроенных устройствах. В этих случаях запрос на окно DECORATED или UTILITY будет принят, но декорации не будут отображаться.

Владелец

Stage может опционально иметь владельца Window. Когда окно является владельцем Stage, оно считается родителем этого Stage.

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

Владелец должен быть инициализирован до того, как Stage станет видимым.

Модальность

Stage имеет один из следующих режимов модальности:

  • Modality.NONE — Stage, который не блокирует другие окна.
  • Modality.WINDOW_MODAL — Stage, который блокирует события ввода для всех окон от владельца (родителя) до корня. Корнем является ближайшее родительское окно без владельца.
  • Modality.APPLICATION_MODAL — Stage, который блокирует события ввода для всех окон из того же приложения, за исключением окон его дочерней иерархии.

Когда окно заблокировано модальным Stage, его порядок следования относительно предков сохраняется, и оно не получает событий ввода и событий активации окна, но продолжает анимацию и отрисовку нормально. Обратите внимание, что показ модального Stage не обязательно блокирует вызывающий код. Метод show() возвращает значение немедленно независимо от режима модальности Stage. Используйте метод showAndWait(), если вам нужно заблокировать вызывающий код до тех пор, пока модальное Stage не будет скрыто (закрыто). Режим модальности должен быть инициализирован до того, как Stage станет видимым.

Пример:


import javafx.application.Application;
import javafx.scene.Group;
import javafx.scene.Scene;
import javafx.scene.text.Font;
import javafx.scene.text.Text;
import javafx.stage.Stage;

public class HelloWorld extends Application {

    @Override public void start(Stage stage) {
        Text text = new Text(10, 40, "Hello World!");
        text.setFont(new Font(40));
        Scene scene = new Scene(new Group(text));

        stage.setTitle("Welcome to JavaFX!");
        stage.setScene(scene);
        stage.sizeToScene();
        stage.show();
    }

    public static void main(String[] args) {
        Application.launch(args);
    }
}

производит следующее на Windows:

A visual rendering of a JavaFX Stage on Windows

производит следующее на Mac OSX:

A visual rendering of a JavaFX Stage on Mac OSX

производит следующее на Linux:

A visual rendering of a JavaFX Stage on Linux

C момента:
JavaFX 2.0

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

Тип Свойство Описание
final ReadOnlyBooleanProperty alwaysOnTop
Определяет, будет ли данный Stage оставаться сверху других окон.
final ObjectProperty<String> fullScreenExitHint
Указывает текст, который будет отображаться, когда пользователь переходит в полноэкранный режим, обычно используется для указания способа выхода из полноэкранного режима.
final ObjectProperty<KeyCombination> fullScreenExitKey
Получить свойство для комбинации клавиш выхода из полноэкранного режима.
final ReadOnlyBooleanProperty fullScreen
Указывает, должен ли данный Stage быть полноэкранным окном без декораций.
final ReadOnlyBooleanProperty iconified
Определяет, свёрнуто ли окно Stage или нет.
final DoubleProperty maxHeight
Определяет максимальную высоту данного Stage.
final ReadOnlyBooleanProperty maximized
Определяет, максимизировано ли окно Stage или нет.
final DoubleProperty maxWidth
Определяет максимальную ширину данного Stage.
final DoubleProperty minHeight
Определяет минимальную высоту данного Stage.
final DoubleProperty minWidth
Определяет минимальную ширину данного Stage.
final BooleanProperty resizable
Определяет, может ли пользователь изменять размер Stage или нет.
final StringProperty title
Определяет заголовок данного Stage.

Свойства, объявленные в классе javafx.stage.Window

eventDispatcher, focused, forceIntegerRenderScale, height, onCloseRequest, onHidden, onHiding, onShowing, onShown, opacity, outputScaleX, outputScaleY, renderScaleX, renderScaleY, scene, showing, width, x, y

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

Конструктор Описание
Stage()
Создаёт новый экземпляр декорированного Stage.
Stage(StageStyle style)
Создаёт новый экземпляр Stage.

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

Модификатор и тип Метод Описание
final ReadOnlyBooleanProperty alwaysOnTopProperty()
Определяет, будет ли эта Stage расположена поверх других окон.
void close()
Закрывает это Stage.
final ObjectProperty<String> fullScreenExitHintProperty()
Устанавливает текст, отображаемый при переходе в полноэкранный режим, обычно используется для указания способа выхода из полноэкранного режима.
final ObjectProperty<KeyCombination> fullScreenExitKeyProperty()
Получить свойство комбинации клавиш для выхода из полноэкранного режима.
final ReadOnlyBooleanProperty fullScreenProperty()
Определяет, должно ли это Stage быть полноэкранным окном без декораций.
final String getFullScreenExitHint()
Получить значение свойства fullScreenExitHint.
final KeyCombination getFullScreenExitKeyCombination()
Получить текущую последовательность для выхода из полноэкранного режима.
final ObservableList<Image> getIcons()
Получить значки-изображения, используемые в декорациях окна и при минимизации.
final double getMaxHeight()
Получить значение свойства maxHeight.
final double getMaxWidth()
Получить значение свойства maxWidth.
final double getMinHeight()
Получить значение свойства minHeight.
final double getMinWidth()
Получить значение свойства minWidth.
final Modality getModality()
Получить атрибут модальности для этой стадии.
final Window getOwner()
Получить окно-владелец для этой стадии или null для стадии без владельца.
final StageStyle getStyle()
Получить атрибут стиля для этой стадии.
final String getTitle()
Получить значение свойства title.
final ReadOnlyBooleanProperty iconifiedProperty()
Определяет, является ли Stage значком или нет.
final void initModality(Modality modality)
Устанавливает модальность для этой стадии.
final void initOwner(Window owner)
Устанавливает окно-владелец для этой стадии или null для верхнего уровня без владельца.
final void initStyle(StageStyle style)
Устанавливает стиль для этой стадии.
final boolean isAlwaysOnTop()
Получить значение свойства alwaysOnTop.
final boolean isFullScreen()
Получить значение свойства fullScreen.
final boolean isIconified()
Получить значение свойства iconified.
final boolean isMaximized()
Получить значение свойства maximized.
final boolean isResizable()
Получить значение свойства resizable.
final DoubleProperty maxHeightProperty()
Определяет максимальную высоту этого Stage.
final ReadOnlyBooleanProperty maximizedProperty()
Определяет, максимизирована ли Stage или нет.
final DoubleProperty maxWidthProperty()
Определяет максимальную ширину этого Stage.
final DoubleProperty minHeightProperty()
Определяет минимальную высоту этого Stage.
final DoubleProperty minWidthProperty()
Определяет минимальную ширину этого Stage.
final BooleanProperty resizableProperty()
Определяет, можно ли пользователю изменять размер Stage.
final void setAlwaysOnTop(boolean value)
Устанавливает значение свойства alwaysOnTop.
final void setFullScreen(boolean value)
Устанавливает значение свойства fullScreen.
final void setFullScreenExitHint(String value)
Устанавливает значение свойства fullScreenExitHint.
final void setFullScreenExitKeyCombination(KeyCombination keyCombination)
Устанавливает комбинацию клавиш для выхода из полноэкранного режима.
final void setIconified(boolean value)
Устанавливает значение свойства iconified.
final void setMaxHeight(double value)
Устанавливает значение свойства maxHeight.
final void setMaximized(boolean value)
Устанавливает значение свойства maximized.
final void setMaxWidth(double value)
Устанавливает значение свойства maxWidth.
final void setMinHeight(double value)
Устанавливает значение свойства minHeight.
final void setMinWidth(double value)
Устанавливает значение свойства minWidth.
final void setResizable(boolean value)
Устанавливает значение свойства resizable.
final void setScene(Scene value)
Указывает сцену, используемую на этой стадии.
final void setTitle(String value)
Устанавливает значение свойства title.
final void show()
Попытка показать это окно, установив видимость в true
void showAndWait()
Отображает эту стадию и ожидает, пока она не будет скрыта (закрыта), прежде чем вернуться к вызывающему.
final StringProperty titleProperty()
Определяет заголовок Stage.
void toBack()
Отправляет это Stage назад, если сцена видима.
void toFront()
Выводит это Stage вперёд, если сцена видима.

Методы, объявленные в классе 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, hide, 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, showingProperty, sizeToScene, widthProperty, xProperty, yProperty

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

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

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

полноэкранный

public final ReadOnlyBooleanProperty fullScreenProperty
Указывает, должен ли этот Stage быть полноэкранным окном без декораций.

Реализация полноэкранного режима зависит от платформы и профиля.

При установке в значение true, Stage попытается перейти в полноэкранный режим при отображении. Установите в значение false, чтобы вернуться в режим окна Stage. Если это свойство устанавливается в потоке, отличном от потока приложения JavaFX, будет брошено исключение IllegalStateException.

Полноэкранный режим будет закрыт (и атрибут fullScreen будет установлен в значение false), если полноэкранный Stage потеряет фокус или если другой Stage перейдёт в полноэкранный режим на той же Screen. Обратите внимание, что Stage в полноэкранном режиме может стать невидимым, не теряя при этом полноэкранного статуса, и снова перейдёт в полноэкранный режим, когда Stage станет видимым.

Если платформа поддерживает несколько экранов, приложение может управлять экраном, на котором окно Stage перейдет в полноэкранный режим, установив его положение в пределах границ этого Screen до перехода в полноэкранный режим.

Однако после перехода в полноэкранный режим, переменные Stage's x, y, width и height будут по-прежнему представлять положение и размер окна без полноэкранного режима, также как и iconified, resizable, style и opacity. Если какие-либо из этих атрибутов будут изменены при нахождении в полноэкранном режиме, при выходе из полноэкранного режима Stage примет эти атрибуты.

В случае одновременной установки нескольких режимов Stage, порядок их важности следующий: iconified, полноэкранный, maximized (от самого сильного к самому слабому).

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

Пользователь может в любой момент без ограничений выйти из полноэкранного режима, нажав ESC.

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

  • Приложения могут перейти в полноэкранный режим только в ответ на пользовательский ввод. Более конкретно, вход разрешен из обработчиков событий мыши (Node.mousePressed/mouseReleased/mouseClicked) или клавиатуры (Node.keyPressed/keyReleased/keyTyped). Вход в полноэкранный режим в ответ на ESC не разрешен. Попытка перехода в полноэкранный режим из любого другого контекста будет проигнорирована.

    Если Stage был создан как полноэкранный, но не виден, он перейдёт в полноэкранный режим при отображении, с теми же ограничениями, что и при установке fullScreen в true.

  • Если приложению разрешено перейти в полноэкранный режим, у него будет ограниченный ввод с клавиатуры. Оно будет получать только события KEY_PRESSED и KEY_RELEASED от следующих клавиш: UP, DOWN, LEFT, RIGHT, SPACE, TAB, PAGE_UP, PAGE_DOWN, HOME, END, ENTER
Значение по умолчанию:
false
См. также:
  • isFullScreen()
  • setFullScreen(boolean)
  • fullScreenProperty()

заголовок

public final StringProperty titleProperty
Определяет заголовок Stage.
Значение по умолчанию:
пустая строка
См. также:
  • getTitle()
  • setTitle(String)
  • titleProperty()

минимизирован

public final ReadOnlyBooleanProperty iconifiedProperty
Определяет, является ли Stage свёрнутым или нет.

В случае одновременной установки нескольких режимов Stage порядок их важности таков: iconified} fullScreen, maximized (от самого сильного к самому слабому).

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

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

Значение по умолчанию:
false
См. также:
  • isIconified()
  • setIconified(boolean)
  • iconifiedProperty()

развёрнутый

public final ReadOnlyBooleanProperty maximizedProperty
Определяет, является ли Stage развёрнутым или нет.

В случае одновременной установки нескольких режимов Stage, порядок их важности таков: iconified, fullScreen, развёрнутый (от самого сильного к самому слабому).

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

Значение по умолчанию:
false
С:
JavaFX 8.0
См. также:
  • isMaximized()
  • setMaximized(boolean)
  • maximizedProperty()

всегда сверху

public final ReadOnlyBooleanProperty alwaysOnTopProperty
Определяет, находится ли это Stage поверх других окон.

Если какое-либо другое окно уже расположено всегда сверху, то относительный порядок между этими окнами не определён (зависит от платформы).

Если присутствует менеджер безопасности, для того чтобы это свойство имело какой-либо эффект, приложение должно иметь FXPermission "setWindowAlwaysOnTop". Если у приложения нет разрешения, попытка установить это свойство будет проигнорирована, и значение свойства будет восстановлено до false.

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

Значение по умолчанию:
false
С:
JavaFX 8u20
См. также:
  • isAlwaysOnTop()
  • setAlwaysOnTop(boolean)
  • alwaysOnTopProperty()

изменяемый размером

public final BooleanProperty resizableProperty
Определяет, может ли пользователь изменять размер Stage или нет. Программно вы по-прежнему можете изменить размер Stage. Это подсказка, которая позволяет реализации сделать Stage изменяемым размером пользователем.

Предупреждение: Начиная с версии 8.0, свойство не может быть привязано и при попытке сделать это будет выброшено исключение RuntimeException. Это связано с тем, что установка свойства resizable на некоторых системах выполняется асинхронно или может быть установлена системой/менеджером окон.
Двунаправленные привязки все еще разрешены, так как они не блокируют установку свойства системой.

Значение по умолчанию:
true
См. также:
  • isResizable()
  • setResizable(boolean)
  • resizableProperty()

минимальная ширина

public final DoubleProperty minWidthProperty
Определяет минимальную ширину этого Stage.
Значение по умолчанию:
0
С:
JavaFX 2.1
См. также:
  • getMinWidth()
  • setMinWidth(double)
  • minWidthProperty()

минимальная высота

public final DoubleProperty minHeightProperty
Определяет минимальную высоту этого Stage.
Значение по умолчанию:
0
С:
JavaFX 2.1
См. также:
  • getMinHeight()
  • setMinHeight(double)
  • minHeightProperty()

максимальная ширина

public final DoubleProperty maxWidthProperty
Определяет максимальную ширину этого Stage.
Значение по умолчанию:
Double.MAX_VALUE
С:
JavaFX 2.1
См. также:
  • getMaxWidth()
  • setMaxWidth(double)
  • maxWidthProperty()

максимальная высота

public final DoubleProperty maxHeightProperty
Определяет максимальную высоту этого Stage.
Значение по умолчанию:
Double.MAX_VALUE
С:
JavaFX 2.1
См. также:
  • getMaxHeight()
  • setMaxHeight(double)
  • maxHeightProperty()

клавиша выхода из полноэкранного режима

public final ObjectProperty<KeyCombination> fullScreenExitKeyProperty
Получить свойство для комбинации клавиш выхода из полноэкранного режима.
С:
JavaFX 8.0
См. также:
  • fullScreenExitKeyProperty()

Подсказка о выходе из полноэкранного режима

public final ObjectProperty<String> fullScreenExitHintProperty
Указывает текст, отображаемый при переходе в полноэкранный режим, обычно используемый для указания способа выхода из полноэкранного режима. Значение null приведет к отображению сообщения по умолчанию для текущего языка. Если значение равно пустой строке, то сообщение не будет отображаться.

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

С момента:
JavaFX 8.0
См. также:
  • getFullScreenExitHint()
  • setFullScreenExitHint(String)
  • fullScreenExitHintProperty()

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

Stage

public Stage()
Создает новый экземпляр декорированного Stage.
Использует:
IllegalStateException - если этот конструктор вызван не в потоке JavaFX Application Thread.

Stage

public Stage(StageStyle style)
Создает новый экземпляр Stage.
Параметры:
style - Стиль Stage
Использует:
IllegalStateException - если этот конструктор вызван не в потоке JavaFX Application Thread.

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

setScene

public final void setScene(Scene value)
Указывает сцену, которая должна быть использована в этом окне.
Переопределяет:
setScene в классе Window
Параметры:
value - значение для свойства scene
См. также:
  • Window.getScene()
  • Window.sceneProperty()

show

public final void show()
Попытка отобразить это окно, установив видимость в значение true
Переопределяет:
show в классе Window

showAndWait

public void showAndWait()
Отображает это окно и ожидает его скрытия (закрытия) перед возвратом вызывающему методу. Этот метод временно блокирует обработку текущего события и запускает вложенный цикл событий для обработки других событий. Этот метод должен вызываться в потоке JavaFX Application.

Окно скрывается (закрывается) одним из следующих способов:

  • приложение вызывает метод Window.hide() или close() в этом окне
  • у этого окна есть окно-владелец, и его владелец закрыт
  • пользователь закрывает окно через систему окон (например, нажав кнопку закрытия в декорации окна)

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

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

void evtHander1(...) {
     stage1.showAndWait();
     doSomethingAfterStage1Closed(...)
 }

 void evtHander2(...) {
     stage1.hide();
     doSomethingElseHere(...)
 }
обработчик1 заблокируется при вызове showAndWait. Он возобновит выполнение после того, как окно1 будет скрыто, и текущий обработчик событий, в данном случае обработчик2, вернется в цикл событий. Это означает, что doSomethingElseHere выполнится до doSomethingAfterStage1Closed.

Одновременно может быть отображено несколько окон с помощью showAndWait. Каждый вызов запустит новый вложенный цикл событий. Окна могут быть скрыты в любом порядке, но конкретный вложенный цикл событий (и, следовательно, метод showAndWait для соответствующего окна) завершится только после завершения всех внутренних циклов событий.

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

void evtHander1() {
     stage1.showAndWait();
     doSomethingAfterStage1Closed(...)
 }

 void evtHander2() {
     stage2.showAndWait();
     doSomethingAfterStage2Closed(...)
 }

 void evtHander3() {
     stage1.hide();
     doSomethingElseHere(...)
 }

 void evtHander4() {
     stage2.hide();
     doSomethingElseHereToo(...)
 }
обработчик1 заблокируется при вызове stage1.showAndWait, запустив вложенный цикл событий, как и в предыдущем примере. обработчик2 затем заблокируется при вызове stage2.showAndWait, запустив другой (внутренний) вложенный цикл событий. Первый вызов stage1.showAndWait возобновит выполнение после того, как stage1 будет скрыто, но только после завершения внутреннего вложенного цикла событий, запущенного stage2.showAndWait. Это означает, что вызов stage1.showAndWait не вернётся, пока не вернётся обработчик2. Порядок выполнения: stage1.showAndWait, stage2.showAndWait, stage1.hide, doSomethingElseHere, stage2.hide, doSomethingElseHereToo, doSomethingAfterStage2Closed, doSomethingAfterStage1Closed.

Этот метод не должен вызываться для основного окна или для окна, которое уже отображается. Кроме того, он должен вызываться либо из обработчика события ввода, либо из метода run в Runnable, переданного в Platform.runLater. Он не должен вызываться во время анимации или обработки макета.

Использует:
IllegalStateException - если этот метод вызван не в потоке JavaFX Application Thread.
IllegalStateException - если этот метод вызван во время анимации или обработки макета.
IllegalStateException - если этот метод вызван для основного окна.
IllegalStateException - если это окно уже отображается.
С момента:
JavaFX 2.2

initStyle

public final void initStyle(StageStyle style)
Устанавливает стиль для этого окна. Это должно быть сделано до отображения окна. Стиль может быть: StageStyle.DECORATED, StageStyle.UNDECORATED, StageStyle.TRANSPARENT или StageStyle.UTILITY.
Значение по умолчанию:
StageStyle.DECORATED
Параметры:
style - стиль для этого окна.
Использует:
IllegalStateException - если это свойство установлено после того, как окно было отображено.

getStyle

public final StageStyle getStyle()
Возвращает атрибут стиля для этого окна.
Возвращает:
стиль окна.

initModality

public final void initModality(Modality modality)
Устанавливает модальность для этого окна. Это должно быть сделано до отображения окна. Модальность может быть: Modality.NONE, Modality.WINDOW_MODAL или Modality.APPLICATION_MODAL.
Значение по умолчанию:
Modality.NONE
Параметры:
modality - модальность для этого окна.
Использует:
IllegalStateException - если это свойство установлено после того, как окно было отображено.
IllegalStateException - если это окно является основным.

getModality

public final Modality getModality()
Возвращает атрибут модальности для этого окна.
Возвращает:
модальность.

initOwner

public final void initOwner(Window owner)
Устанавливает окно-владелец для этого окна или null для независимого окна верхнего уровня. Это должно быть сделано до отображения окна.
Значение по умолчанию:
null
Параметры:
owner - владелец для этого окна.
Использует:
IllegalStateException - если это свойство установлено после того, как окно было отображено.
IllegalStateException - если это окно является основным.

getOwner

public final Window getOwner()
Возвращает окно-владелец для этого окна или null для независимого окна.
Возвращает:
окно-владелец.

setFullScreen

public final void setFullScreen(boolean value)
Устанавливает значение свойства fullScreen.
Описание свойства:
Указывает, будет ли этот Stage полноэкранным окном без декораций.

Реализация полноэкранного режима зависит от платформы и профиля.

При установке в значение true, Stage попытается перейти в полноэкранный режим при видимости. Установка в значение false вернёт Stage в оконный режим. Исключение IllegalStateException выбрасывается, если это свойство устанавливается в потоке, отличном от потока приложения JavaFX.

Полноэкранный режим будет закрыт (и атрибут fullScreen будет установлен в false), если полноэкранное Stage потеряет фокус или если другое Stage перейдёт в полноэкранный режим на той же Screen. Обратите внимание, что Stage в полноэкранном режиме может стать невидимым, не теряя полноэкранного статуса, и снова перейдёт в полноэкранный режим, когда Stage станет видимым.

Если платформа поддерживает несколько экранов, приложение может контролировать, на каком Screen окно Stage перейдёт в полноэкранный режим, установив его положение в пределах границ этого Screen до перехода в полноэкранный режим.

Однако после перехода в полноэкранный режим переменные Stage's x, y, width и height будут продолжать представлять положение и размер окна вне полноэкранного режима; то же самое относится к iconified, resizable, style и opacity. Если изменения внесены в любой из этих атрибутов во время полноэкранного режима, при выходе из полноэкранного режима Stage примет эти атрибуты.

В случае одновременного задания нескольких режимов Stage, их порядок важности — iconified, fullScreen, maximized (от самого сильного к самому слабому).

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

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

Если менеджер безопасности присутствует, приложение должно иметь FXPermission "unrestrictedFullScreen", чтобы перейти в полноэкранный режим без ограничений. Приложения без разрешения будут иметь следующие ограничения:

  • Приложения могут перейти в полноэкранный режим только в ответ на пользовательский ввод. Более конкретно, вход разрешен из обработчиков событий мыши (Node.mousePressed/mouseReleased/mouseClicked) или клавиатуры (Node.keyPressed/keyReleased/keyTyped). Вход в полноэкранный режим в ответ на ESC клавишу не разрешен. Попытка перехода в полноэкранный режим из любого другого контекста будет проигнорирована.

    Если Stage было создано в полноэкранном режиме, но невидимым, оно перейдёт в полноэкранный режим при появлении, с теми же ограничениями на разрешение, как и при установке fullScreen в значение true.

  • Если приложению разрешено перейти в полноэкранный режим, у него будет ограниченный ввод с клавиатуры. Оно будет получать только события KEY_PRESSED и KEY_RELEASED от следующих клавиш: UP, DOWN, LEFT, RIGHT, SPACE, TAB, PAGE_UP, PAGE_DOWN, HOME, END, ENTER
Значение по умолчанию:
false
Параметры:
value - значение свойства fullScreen
См. также:
  • isFullScreen()
  • fullScreenProperty()

isFullScreen

public final boolean isFullScreen()
Получает значение свойства fullScreen.
Описание свойства:
Указывает, будет ли этот Stage полноэкранным окном без декораций.

Реализация полноэкранного режима зависит от платформы и профиля.

При установке в значение true, Stage попытается перейти в полноэкранный режим при видимости. Установка в значение false вернёт Stage в оконный режим. Исключение IllegalStateException выбрасывается, если это свойство устанавливается в потоке, отличном от потока приложения JavaFX.

Полноэкранный режим будет закрыт (и атрибут fullScreen будет установлен в false), если полноэкранное Stage потеряет фокус или если другое Stage перейдёт в полноэкранный режим на той же Screen. Обратите внимание, что Stage в полноэкранном режиме может стать невидимым, не теряя полноэкранного статуса, и снова перейдёт в полноэкранный режим, когда Stage станет видимым.

Если платформа поддерживает несколько экранов, приложение может контролировать, на каком Screen окно Stage перейдёт в полноэкранный режим, установив его положение в пределах границ этого Screen до перехода в полноэкранный режим.

Однако после перехода в полноэкранный режим переменные Stage's x, y, width и height будут продолжать представлять положение и размер окна вне полноэкранного режима; то же самое относится к iconified, resizable, style и opacity. Если изменения внесены в любой из этих атрибутов во время полноэкранного режима, при выходе из полноэкранного режима Stage примет эти атрибуты.

В случае одновременного задания нескольких режимов Stage, их порядок важности — iconified, fullScreen, maximized (от самого сильного к самому слабому).

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

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

Если менеджер безопасности присутствует, приложение должно иметь FXPermission "unrestrictedFullScreen", чтобы перейти в полноэкранный режим без ограничений. Приложения без разрешения будут иметь следующие ограничения:

  • Приложения могут перейти в полноэкранный режим только в ответ на пользовательский ввод. Более конкретно, вход разрешен из обработчиков событий мыши (Node.mousePressed/mouseReleased/mouseClicked) или клавиатуры (Node.keyPressed/keyReleased/keyTyped). Вход в полноэкранный режим в ответ на ESC клавишу не разрешен. Попытка перехода в полноэкранный режим из любого другого контекста будет проигнорирована.

    Если Stage было создано в полноэкранном режиме, но невидимым, оно перейдёт в полноэкранный режим при появлении, с теми же ограничениями на разрешение, как и при установке fullScreen в значение true.

  • Если приложению разрешено перейти в полноэкранный режим, у него будет ограниченный ввод с клавиатуры. Оно будет получать только события KEY_PRESSED и KEY_RELEASED от следующих клавиш: UP, DOWN, LEFT, RIGHT, SPACE, TAB, PAGE_UP, PAGE_DOWN, HOME, END, ENTER
Значение по умолчанию:
false
Возвращает:
значение свойства fullScreen
См. также:
  • setFullScreen(boolean)
  • fullScreenProperty()

fullScreenProperty

public final ReadOnlyBooleanProperty fullScreenProperty()
Указывает, будет ли это Stage полноэкранным окном без декораций.

Реализация полноэкранного режима зависит от платформы и профиля.

При установке в значение true, Stage попытается перейти в полноэкранный режим при видимости. Установите в значение false, чтобы вернуться Stage в оконный режим. Бросается исключение IllegalStateException, если этот параметр устанавливается в потоке, отличном от потока JavaFX Application Thread.

Полноэкранный режим будет закрыт (и атрибут fullScreen будет установлен в значение false), если полноэкранное Stage потеряет фокус или если другой Stage перейдет в полноэкранный режим на том же Screen. Обратите внимание, что Stage в полноэкранном режиме может стать невидимым, не теряя своего полноэкранного статуса, и снова перейдет в полноэкранный режим, когда Stage станет видимым.

Если платформа поддерживает несколько экранов, приложение может управлять тем, на каком Screen Stage перейдет в полноэкранный режим, установив его положение в пределах границ этого Screen перед переходом в полноэкранный режим.

Однако после перехода в полноэкранный режим, переменные Stage's x, y, width и height по-прежнему будут представлять положение и размер окна в обычном (не полноэкранном) режиме; то же самое относится к iconified, resizable, style и opacity. Если изменения внесены в любой из этих атрибутов во время полноэкранного режима, при выходе из полноэкранного режима Stage примет эти атрибуты.

В случае одновременной установки нескольких режимов Stage их порядок важности — iconified, fullScreen, maximized (от самого сильного к самому слабому).

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

Пользователь может в любое время беспрепятственно выйти из полноэкранного режима, нажав ESC.

Если присутствует менеджер безопасности, приложение должно иметь разрешение FXPermission "unrestrictedFullScreen", чтобы перейти в полноэкранный режим без ограничений. Приложения без разрешения будут иметь следующие ограничения:

  • Приложения могут перейти в полноэкранный режим только в ответ на пользовательский ввод. Более конкретно, вход разрешен из обработчиков событий мыши (Node.mousePressed/mouseReleased/mouseClicked) или клавиатуры (Node.keyPressed/keyReleased/keyTyped). Вход в полноэкранный режим в ответ на ESC не разрешен. Попытки перейти в полноэкранный режим из любого другого контекста будут проигнорированы.

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

  • Если приложение разрешено перейти в полноэкранный режим, у него будет ограниченный ввод с клавиатуры. Оно будет получать только события KEY_PRESSED и KEY_RELEASED от следующих клавиш: UP, DOWN, LEFT, RIGHT, SPACE, TAB, PAGE_UP, PAGE_DOWN, HOME, END, ENTER
Значение по умолчанию:
false
Возвращает:
свойство fullScreen
См. также:
  • isFullScreen()
  • setFullScreen(boolean)

getIcons

public final ObservableList<Image> getIcons()
Возвращает изображения значков, используемые в декорациях окна и при сворачивании. Изображения должны быть разных размеров одного и того же изображения, и будет выбран лучший размер, например, 16x16, 32x32.
Возвращает:
Наблюдаемый список значков этого окна

setTitle

public final void setTitle(String value)
Устанавливает значение свойства title.
Описание свойства:
Определяет заголовок Stage.
Значение по умолчанию:
пустая строка
Параметры:
value - значение для свойства title
См. также:
  • getTitle()
  • titleProperty()

getTitle

public final String getTitle()
Получает значение свойства title.
Описание свойства:
Определяет заголовок Stage.
Значение по умолчанию:
пустая строка
Возвращает:
значение свойства title
См. также:
  • setTitle(String)
  • titleProperty()

titleProperty

public final StringProperty titleProperty()
Определяет заголовок Stage.
Значение по умолчанию:
пустая строка
Возвращает:
свойство title
См. также:
  • getTitle()
  • setTitle(String)

setIconified

public final void setIconified(boolean value)
Устанавливает значение свойства iconified.
Описание свойства:
Определяет, сворачивается ли Stage в значок или нет.

В случае одновременной установки нескольких режимов Stage их порядок важности — iconified} fullScreen, maximized (от самого сильного к самому слабому).

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

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

Значение по умолчанию:
false
Параметры:
value - значение для свойства iconified
См. также:
  • isIconified()
  • iconifiedProperty()

isIconified

public final boolean isIconified()
Получает значение свойства iconified.
Описание свойства:
Определяет, сворачивается ли Stage в значок или нет.

В случае одновременной установки нескольких режимов Stage их порядок важности — iconified} fullScreen, maximized (от самого сильного к самому слабому).

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

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

Значение по умолчанию:
false
Возвращает:
значение свойства iconified
См. также:
  • setIconified(boolean)
  • iconifiedProperty()

iconifiedProperty

public final ReadOnlyBooleanProperty iconifiedProperty()
Определяет, сворачивается ли Stage в значок или нет.

В случае одновременной установки нескольких режимов Stage их порядок важности — iconified} fullScreen, maximized (от самого сильного к самому слабому).

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

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

Значение по умолчанию:
false
Возвращает:
свойство iconified
См. также:
  • isIconified()
  • setIconified(boolean)

setMaximized

public final void setMaximized(boolean value)
Устанавливает значение свойства maximized.
Описание свойства:
Определяет, максимализирован ли Stage или нет.

В случае одновременной установки нескольких режимов Stage их порядок важности — iconified, fullScreen, maximized (от самого сильного к самому слабому).

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

Значение по умолчанию:
false
Параметры:
value - значение для свойства maximized
Since:
JavaFX 8.0
См. также:
  • isMaximized()
  • maximizedProperty()
END_OF_DOCUMENT_MARKER

isMaximized

public final boolean isMaximized()
Получает значение свойства maximized.
Описание свойства:
Определяет, является ли Stage максимализированным или нет.

В случае одновременного задания нескольких режимов Stage, их порядок важности следующий: iconified, fullScreen, максимализирован (от наибольшего к наименьшему).

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

Значение по умолчанию:
false
Возвращает:
значение свойства maximized
С:
JavaFX 8.0
См. также:
  • setMaximized(boolean)
  • maximizedProperty()

maximizedProperty

public final ReadOnlyBooleanProperty maximizedProperty()
Определяет, является ли Stage максимализированным или нет.

В случае одновременного задания нескольких режимов Stage, их порядок важности следующий: iconified, fullScreen, максимализирован (от наибольшего к наименьшему).

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

Значение по умолчанию:
false
Возвращает:
свойство maximized
С:
JavaFX 8.0
См. также:
  • isMaximized()
  • setMaximized(boolean)

setAlwaysOnTop

public final void setAlwaysOnTop(boolean value)
Устанавливает значение свойства alwaysOnTop.
Описание свойства:
Определяет, будет ли этот Stage оставаться поверх других окон.

Если какое-то другое окно уже находится всегда поверх, то относительный порядок этих окон не определён (зависит от платформы).

Если менеджер безопасности присутствует, для того, чтобы это свойство имело какой-либо эффект, приложение должно иметь разрешение FXPermission "setWindowAlwaysOnTop". Если у приложения нет разрешения, попытка установить это свойство будет проигнорирована, и значение свойства будет восстановлено до false.

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

Значение по умолчанию:
false
Параметры:
value - значение для свойства alwaysOnTop
С:
JavaFX 8u20
См. также:
  • isAlwaysOnTop()
  • alwaysOnTopProperty()

isAlwaysOnTop

public final boolean isAlwaysOnTop()
Получает значение свойства alwaysOnTop.
Описание свойства:
Определяет, будет ли это Stage оставаться поверх других окон.

Если какое-то другое окно уже находится всегда поверх, то относительный порядок этих окон не определён (зависит от платформы).

Если менеджер безопасности присутствует, для того, чтобы это свойство имело какой-либо эффект, приложение должно иметь разрешение FXPermission "setWindowAlwaysOnTop". Если у приложения нет разрешения, попытка установить это свойство будет проигнорирована, и значение свойства будет восстановлено до false.

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

Значение по умолчанию:
false
Возвращает:
значение свойства alwaysOnTop
С:
JavaFX 8u20
См. также:
  • setAlwaysOnTop(boolean)
  • alwaysOnTopProperty()

alwaysOnTopProperty

public final ReadOnlyBooleanProperty alwaysOnTopProperty()
Определяет, будет ли это Stage оставаться поверх других окон.

Если какое-то другое окно уже находится всегда поверх, то относительный порядок этих окон не определён (зависит от платформы).

Если менеджер безопасности присутствует, для того, чтобы это свойство имело какой-либо эффект, приложение должно иметь разрешение FXPermission "setWindowAlwaysOnTop". Если у приложения нет разрешения, попытка установить это свойство будет проигнорирована, и значение свойства будет восстановлено до false.

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

Значение по умолчанию:
false
Возвращает:
свойство alwaysOnTop
С:
JavaFX 8u20
См. также:
  • isAlwaysOnTop()
  • setAlwaysOnTop(boolean)

setResizable

public final void setResizable(boolean value)
Устанавливает значение свойства resizable.
Описание свойства:
Определяет, может ли Stage быть изменён пользователем. Программно вы всё ещё можете изменить размер Stage. Это подсказка, которая позволяет реализации сделать Stage изменяемым пользователем.

Предупреждение: Начиная с 8.0, свойство не может быть привязано, и попытка сделать это вызовет RuntimeException. Это связано с тем, что установка resizable может быть асинхронной на некоторых системах или, в общем, может устанавливаться системой/менеджером окон.
Двунаправленные привязки всё ещё разрешены, так как они не блокируют установку свойства системой.

Значение по умолчанию:
true
Параметры:
value - значение для свойства resizable
См. также:
  • isResizable()
  • resizableProperty()

isResizable

public final boolean isResizable()
Получает значение свойства resizable.
Описание свойства:
Определяет, может ли Stage быть изменён пользователем. Программно вы всё ещё можете изменить размер Stage. Это подсказка, которая позволяет реализации сделать Stage изменяемым пользователем.

Предупреждение: Начиная с 8.0, свойство не может быть привязано, и попытка сделать это вызовет RuntimeException. Это связано с тем, что установка resizable может быть асинхронной на некоторых системах или, в общем, может устанавливаться системой/менеджером окон.
Двунаправленные привязки всё ещё разрешены, так как они не блокируют установку свойства системой.

Значение по умолчанию:
true
Возвращает:
значение свойства resizable
См. также:
  • setResizable(boolean)
  • resizableProperty()

resizableProperty

public final BooleanProperty resizableProperty()
Определяет, может ли Stage быть изменён пользователем. Программно вы всё ещё можете изменить размер Stage. Это подсказка, которая позволяет реализации сделать Stage изменяемым пользователем.

Предупреждение: Начиная с 8.0, свойство не может быть привязано, и попытка сделать это вызовет RuntimeException. Это связано с тем, что установка resizable может быть асинхронной на некоторых системах или, в общем, может устанавливаться системой/менеджером окон.
Двунаправленные привязки всё ещё разрешены, так как они не блокируют установку свойства системой.

Значение по умолчанию:
true
Возвращает:
свойство resizable
См. также:
  • isResizable()
  • setResizable(boolean)

setMinWidth

public final void setMinWidth(double value)
Устанавливает значение свойства minWidth.
Описание свойства:
Определяет минимальную ширину этого Stage.
Значение по умолчанию:
0
Параметры:
value - значение для свойства minWidth
С:
JavaFX 2.1
См. также:
  • getMinWidth()
  • minWidthProperty()

getMinWidth

public final double getMinWidth()
Получает значение свойства minWidth.
Описание свойства:
Определяет минимальную ширину этого Stage.
Значение по умолчанию:
0
Возвращает:
значение свойства minWidth
С:
JavaFX 2.1
См. также:
  • setMinWidth(double)
  • minWidthProperty()

minWidthProperty

public final DoubleProperty minWidthProperty()
Определяет минимальную ширину этого Stage.
Значение по умолчанию:
0
Возвращает:
свойство minWidth
С:
JavaFX 2.1
См. также:
  • getMinWidth()
  • setMinWidth(double)

УстановитьМинимальнуюВысоту

public final void setMinHeight(double value)
Устанавливает значение свойства minHeight.
Описание свойства:
Определяет минимальную высоту этого Stage.
Значение по умолчанию:
0
Параметры:
value - значение для свойства minHeight
С тех пор:
JavaFX 2.1
См. также:
  • getMinHeight()
  • minHeightProperty()

ПолучитьМинимальнуюВысоту

public final double getMinHeight()
Получает значение свойства minHeight.
Описание свойства:
Определяет минимальную высоту этого Stage.
Значение по умолчанию:
0
Возвращает:
значение свойства minHeight
С тех пор:
JavaFX 2.1
См. также:
  • setMinHeight(double)
  • minHeightProperty()

СвойствоМинимальнойВысоты

public final DoubleProperty minHeightProperty()
Определяет минимальную высоту этого Stage.
Значение по умолчанию:
0
Возвращает:
свойство minHeight
С тех пор:
JavaFX 2.1
См. также:
  • getMinHeight()
  • setMinHeight(double)

УстановитьМаксимальнуюШирину

public final void setMaxWidth(double value)
Устанавливает значение свойства maxWidth.
Описание свойства:
Определяет максимальную ширину этого Stage.
Значение по умолчанию:
Double.MAX_VALUE
Параметры:
value - значение для свойства maxWidth
С тех пор:
JavaFX 2.1
См. также:
  • getMaxWidth()
  • maxWidthProperty()

ПолучитьМаксимальнуюШирину

public final double getMaxWidth()
Получает значение свойства maxWidth.
Описание свойства:
Определяет максимальную ширину этого Stage.
Значение по умолчанию:
Double.MAX_VALUE
Возвращает:
значение свойства maxWidth
С тех пор:
JavaFX 2.1
См. также:
  • setMaxWidth(double)
  • maxWidthProperty()

СвойствоМаксимальнойШирины

public final DoubleProperty maxWidthProperty()
Определяет максимальную ширину этого Stage.
Значение по умолчанию:
Double.MAX_VALUE
Возвращает:
свойство maxWidth
С тех пор:
JavaFX 2.1
См. также:
  • getMaxWidth()
  • setMaxWidth(double)

УстановитьМаксимальнуюВысоту

public final void setMaxHeight(double value)
Устанавливает значение свойства maxHeight.
Описание свойства:
Определяет максимальную высоту этого Stage.
Значение по умолчанию:
Double.MAX_VALUE
Параметры:
value - значение для свойства maxHeight
С тех пор:
JavaFX 2.1
См. также:
  • getMaxHeight()
  • maxHeightProperty()

ПолучитьМаксимальнуюВысоту

public final double getMaxHeight()
Получает значение свойства maxHeight.
Описание свойства:
Определяет максимальную высоту этого Stage.
Значение по умолчанию:
Double.MAX_VALUE
Возвращает:
значение свойства maxHeight
С тех пор:
JavaFX 2.1
См. также:
  • setMaxHeight(double)
  • maxHeightProperty()

СвойствоМаксимальнойВысоты

public final DoubleProperty maxHeightProperty()
Определяет максимальную высоту этого Stage.
Значение по умолчанию:
Double.MAX_VALUE
Возвращает:
свойство maxHeight
С тех пор:
JavaFX 2.1
См. также:
  • getMaxHeight()
  • setMaxHeight(double)

ВывестиВперед

public void toFront()
Выводит этот Stage вперед, если окно отображается. Это действие помещает этот Stage в верхнюю часть стековой очереди и отображает его перед любым другим окном Stage, созданным этим приложением.

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

ВывестиНазад

public void toBack()
Отправляет этот Stage назад, если окно отображается. Это действие помещает этот Stage в нижнюю часть стековой очереди и отображает его позади любого другого окна Stage, созданного этим приложением.

Некоторые платформы не позволяют приложениям контролировать порядок стековой очереди, в этом случае этот метод ничего не делает. Другие платформы имеют ограничения на порядок стековой очереди, поэтому могут не размещать окно под окнами другого приложения, а также не разрешать окну, управляемому другим окном, отображаться под своим владельцем. Будет предпринята вся возможная попытка перемещения этого Stage как можно ниже в стековой очереди; однако разработчики не должны предполагать, что этот метод поместит это Stage под все другие окна в каждой ситуации.

Закрыть

public void close()
Закрывает это Stage. Этот вызов эквивалентен hide().

УстановитьСочетаниеКлавишВыходаИзПолноэкранногоРежима

public final void setFullScreenExitKeyCombination(KeyCombination keyCombination)
Указывает сочетание клавиш, которое позволит пользователю выйти из полноэкранного режима. Значение KeyCombination.NO_MATCH не будет соответствовать никаким событиям KeyEvent и не позволит пользователю выйти из полноэкранного режима. Значение null указывает на то, что должно использоваться стандартное сочетание клавиш, специфичное для платформы.

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

Параметры:
keyCombination - сочетание клавиш для выхода
С тех пор:
JavaFX 8.0

ПолучитьСочетаниеКлавишВыходаИзПолноэкранногоРежима

public final KeyCombination getFullScreenExitKeyCombination()
Получить текущее сочетание клавиш для выхода из полноэкранного режима.
Возвращает:
текущее значение (null для системного значения по умолчанию)
С тех пор:
JavaFX 8.0

СвойствоСочетанияКлавишВыходаИзПолноэкранногоРежима

public final ObjectProperty<KeyCombination> fullScreenExitKeyProperty()
Получить свойство для сочетания клавиш выхода из полноэкранного режима.
Возвращает:
свойство.
С тех пор:
JavaFX 8.0

УстановитьПодсказкуВыходаИзПолноэкранногоРежима

public final void setFullScreenExitHint(String value)
Устанавливает значение свойства fullScreenExitHint.
Описание свойства:
Указывает текст, который отображается при входе в полноэкранный режим, обычно используется для указания способа выхода из полноэкранного режима. Значение null приведет к отображению сообщения по умолчанию для текущего языка. Значение пустой строки приведет к тому, что сообщение не будет отображаться.

Если присутствует менеджер безопасности, приложение должно иметь разрешение FXPermission "unrestrictedFullScreen" для изменения подсказки выхода. Если у приложения нет разрешения, значение этого свойства будет проигнорировано, в этом случае будет отображено стандартное сообщение.

Параметры:
value - значение для свойства fullScreenExitHint
С тех пор:
JavaFX 8.0
См. также:
  • getFullScreenExitHint()
  • fullScreenExitHintProperty()

Получить подсказку выхода из полноэкранного режима

public final String getFullScreenExitHint()
Получает значение свойства fullScreenExitHint.
Описание свойства:
Указывает текст, отображаемый при входе пользователя в полноэкранный режим, обычно используется для указания способа выхода из полноэкранного режима. Значение null приведет к отображению сообщения по умолчанию для текущего языка. Если значение установлено на пустую строку, сообщение не будет отображаться.

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

Возвращает:
значение свойства fullScreenExitHint
С:
JavaFX 8.0
См. также:
  • setFullScreenExitHint(String)
  • fullScreenExitHintProperty()

Свойство fullScreenExitHint

public final ObjectProperty<String> fullScreenExitHintProperty()
Указывает текст, отображаемый при входе пользователя в полноэкранный режим, обычно используется для указания способа выхода из полноэкранного режима. Значение null приведет к отображению сообщения по умолчанию для текущего языка. Если значение установлено на пустую строку, сообщение не будет отображаться.

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

Возвращает:
свойство fullScreenExitHint
С:
JavaFX 8.0
См. также:
  • getFullScreenExitHint()
  • setFullScreenExitHint(String)

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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API