Spec-Zone.ru › OpenJavaFX 17

Класс Platform

java.lang.Object
javafx.application.Platform
public final class Platform
extends Object
Класс поддержки платформы приложения.
Since:
JavaFX 2.0

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

Свойства
Тип Свойство Описание
static ReadOnlyBooleanProperty accessibilityActive
Указывает, включена ли поддержка доступности.

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

Модификатор и тип Метод Описание
static ReadOnlyBooleanProperty accessibilityActiveProperty()
Указывает, включена ли поддержка доступности.
static Object enterNestedEventLoop​(Object key)
Входит во вложенный цикл обработки событий и блокируется до вызова соответствующего exitNestedEventLoop.
static void exit()
Приводит к завершению приложения JavaFX.
static void exitNestedEventLoop​(Object key, Object rval)
Выходит из вложенного цикла обработки событий и разблокирует вызывающего метод enterNestedEventLoop.
static boolean isAccessibilityActive()
Получает значение свойства accessibilityActive.
static boolean isFxApplicationThread()
Возвращает true, если вызывающая нить является JavaFX Application Thread.
static boolean isImplicitExit()
Получает значение атрибута implicitExit.
static Optional<Boolean> isKeyLocked​(KeyCode keyCode)
Возвращает флаг, указывающий, находится ли ключ, соответствующий keyCode, в заблокированном (или "включенном") состоянии.
static boolean isNestedLoopRunning()
Проверяет, выполняется ли вложенный цикл обработки событий, возвращая true, если он выполняется, и false, если вложенные циклы обработки событий не выполняются.
static boolean isSupported​(ConditionalFeature feature)
Запрашивает, поддерживается ли конкретная условная функция платформой.
static void requestNextPulse()
Запрашивает Java Runtime выполнить пульс.
static void runLater​(Runnable runnable)
Выполняет указанный Runnable в JavaFX Application Thread в неопределенное время в будущем.
static void setImplicitExit​(boolean implicitExit)
Устанавливает значение атрибута implicitExit.
static void startup​(Runnable runnable)
Этот метод запускает JavaFX runtime.

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

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

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

accessibilityActive

public static ReadOnlyBooleanProperty accessibilityActiveProperty
Указывает, активна ли функция доступности. Это свойство обычно устанавливается в значение true в первый раз, когда технология辅助, например, экранный ридер, запрашивает информацию о любом окне JavaFX или его дочерних элементах.

Этот метод может быть вызван из любого потока.

С:
JavaFX 8u40
См. также:
isAccessibilityActive()

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

startup

public static void startup(Runnable runnable)
Этот метод запускает среду выполнения JavaFX. Затем указанный Runnable вызывается в потоке приложения JavaFX. В общем случае явно вызывать этот метод не требуется, так как он вызывается как следствие того, как строятся большинство приложений JavaFX. Однако есть и обоснованные случаи для прямого вызова этого метода. Поскольку этот метод запускает среду выполнения JavaFX, в данный момент еще нет потока приложения JavaFX, поэтому нормально, что этот метод вызывается напрямую в главном потоке приложения.

Этот метод может или не может вернуть управление вызывающей стороне до того, как будет вызван метод run указанного Runnable. В любом случае, этот метод не блокируется, ожидая выполнения указанного Runnable. После возвращения из этого метода вы можете вызвать runLater(Runnable) с дополнительными Runnable. Эти Runnable будут вызваны, также в потоке приложения JavaFX, после того, как будет вызван Runnable, переданный в этот метод.

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

  • Для стандартных приложений JavaFX, которые расширяют Application и используют либо загрузчик Java, либо один из методов запуска в классе Application для запуска приложения, среда выполнения FX инициализируется автоматически загрузчиком до загрузки класса Application.
  • Для приложений Swing, которые используют JFXPanel для отображения содержимого FX, среда выполнения FX инициализируется при создании первого экземпляра JFXPanel.
  • Для приложений SWT, которые используют FXCanvas для отображения содержимого FX, среда выполнения FX инициализируется при создании первого экземпляра FXCanvas.

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

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

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

Параметры:
runnable - Runnable, метод run которого будет выполнен в потоке приложения JavaFX после его запуска
Исключения:
IllegalStateException - если среда выполнения JavaFX уже запущена
С:
9
См. также:
Application

runLater

public static void runLater(Runnable runnable)
Выполнить указанный Runnable в потоке приложения JavaFX в какой-то неопределенный момент в будущем. Этот метод, который может быть вызван из любого потока, помещает Runnable в очередь событий и немедленно возвращает управление вызывающей стороне. Runnable выполняются в порядке их размещения. Runnable, переданный в метод runLater, будет выполнен до любого Runnable, переданного в последующий вызов runLater. Если этот метод вызывается после завершения среды выполнения JavaFX, вызов игнорируется: Runnable не будет выполнен, и исключение не будет выброшено.

ПРИМЕЧАНИЕ: приложениям следует избегать перегрузки JavaFX слишком большим количеством ожидающих Runnable. В противном случае приложение может стать неотзывчивым. Приложениям рекомендуется объединять несколько операций в меньшее количество вызовов runLater. Кроме того, длительные операции должны выполняться в фоновом потоке, насколько это возможно, освобождая поток приложения JavaFX для операций с графическим интерфейсом пользователя.

Этот метод не должен вызываться до инициализации среды FX. Для стандартных приложений JavaFX, которые расширяют Application и используют либо загрузчик Java, либо один из методов запуска в классе Application для запуска приложения, среда выполнения FX инициализируется загрузчиком до загрузки класса Application. Для приложений Swing, использующих JFXPanel для отображения содержимого FX, среда выполнения FX инициализируется при создании первого экземпляра JFXPanel. Для приложений SWT, использующих FXCanvas для отображения содержимого FX, среда выполнения FX инициализируется при создании первого экземпляра FXCanvas. Для приложений, не использующих ни один из этих подходов, необходимо вручную запустить среду выполнения JavaFX, вызвав startup(Runnable) один раз.

Параметры:
runnable - Runnable, метод run которого будет выполнен в потоке приложения JavaFX
Исключения:
IllegalStateException - если среда FX не была инициализирована
См. также:
Application

requestNextPulse

public static void requestNextPulse()
Запрашивает у среды выполнения Java выполнение пульса. Это запустит пульс, даже если нет таймеров анимации, изменений в графе сцены или событий окна, которые обычно вызывали бы запуск пульса. Если пульс не выполняется, он будет запланирован на выполнение в следующий раз при срабатывании таймера пульса. Если пульс уже выполняется, будет запланирован как минимум один дополнительный пульс после текущего. Этот метод может быть вызван из любого потока.
С:
9

isFxApplicationThread

public static boolean isFxApplicationThread()
Возвращает true, если вызывающий поток является потоком приложения JavaFX. Используйте этот вызов, чтобы убедиться, что данная задача выполняется (или не выполняется) в потоке приложения JavaFX.
Возвращает:
true, если выполняется в потоке приложения JavaFX

exit

public static void exit()
Принудительно завершает приложение JavaFX. Если этот метод вызывается после вызова метода start класса Application, загрузчик JavaFX вызовет метод stop класса Application и завершит поток приложения JavaFX. Затем поток загрузчика будет завершен. Если больше нет других активных не-демонов потоков, виртуальная машина Java завершится. Если этот метод вызывается из Preloader или метода init класса Application, то метод stop класса Application может не быть вызван.

Этот метод может быть вызван из любого потока.

setImplicitExit

public static void setImplicitExit(boolean implicitExit)
Устанавливает значение атрибута implicitExit. Если этот атрибут равен true, среда выполнения JavaFX будет неявно завершена при закрытии последнего окна; загрузчик JavaFX вызовет метод Application.stop() и завершит поток приложения JavaFX. Если этот атрибут равен false, приложение продолжит работу нормально даже после закрытия последнего окна, до тех пор, пока приложение не вызовет exit(). Значение по умолчанию — true.

Этот метод может быть вызван из любого потока.

Параметры:
implicitExit - флаг, указывающий, следует ли неявно завершать приложение при закрытии последнего окна.
С:
JavaFX 2.2

isImplicitExit

public static boolean isImplicitExit()
Возвращает значение атрибута implicitExit.

Этот метод может быть вызван из любого потока.

Возвращает:
атрибут implicitExit
С:
JavaFX 2.2

isSupported

public static boolean isSupported(ConditionalFeature feature)
Определяет, поддерживается ли платформа определённая условная функция.

Например:

 // Query whether filter effects are supported
 if (Platform.isSupported(ConditionalFeature.EFFECT)) {
    // use effects
 }
 
Параметры:
feature - условная функция.
Возвращает:
true, если платформа поддерживает указанную условную функцию, иначе false

enterNestedEventLoop

public static Object enterNestedEventLoop(Object key)
Входит во вложенный цикл обработки событий и блокируется до вызова соответствующего exitNestedEventLoop. Ключ, переданный в этот метод, используется для уникальной идентификации пар вызовов enter/exit. Этот метод создаёт новый вложенный цикл обработки событий и блокируется до вызова соответствующего метода exitNestedEventLoop с тем же ключом. Результатом этого метода будет объект rval, переданный в вызов метода exitNestedEventLoop, который его разблокирует.

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

Параметры:
key - объект, идентифицирующий вложенный цикл обработки событий, не может быть null
Возвращает:
значение, переданное в соответствующий вызов exitEventLoop
Исключения:
IllegalArgumentException - если указанный ключ связан с вложенным циклом обработки событий, который ещё не завершён
NullPointerException - если ключ равен null
IllegalStateException - если этот метод вызывается во время анимации или обработки макета.
IllegalStateException - если этот метод вызывается в потоке, отличном от потока приложения JavaFX.
С:
9

Выход из вложенного цикла событий

public static void exitNestedEventLoop(Object key, Object rval)
Выход из вложенного цикла событий и разблокировка вызывающего метода соответствующего enterNestedEventLoop. Ключ, переданный в этот метод, используется для уникальной идентификации пары методов enter/exit. Этот метод заставляет вложенный цикл событий, ранее созданный с помощью ключа, завершиться и вернуть управление вызывающему методу. Если указанный вложенный цикл событий не является внутренним, он не вернется, пока все другие внутренние циклы также не завершатся.
Параметры:
key - объект, идентифицирующий вложенный цикл событий, который не должен быть null
rval - объект, возвращаемый вызывающему методу соответствующего enterNestedEventLoop. Может быть null.
Исключения:
IllegalArgumentException - если указанный ключ не ассоциирован с активным вложенным циклом событий
NullPointerException - если ключ null
IllegalStateException - если этот метод вызван на потоке, отличном от потока приложения JavaFX
С:
9

isKeyLocked

public static Optional<Boolean> isKeyLocked(KeyCode keyCode)
Возвращает флаг, указывающий, находится ли ключ, соответствующий keyCode, в заблокированном (или "включенном") состоянии. keyCode должен быть одним из: KeyCode.CAPS или KeyCode.NUM_LOCK. Если основная система не может определить состояние указанного keyCode, возвращается пустой Optional. Если клавиатура, подключенная к системе, не имеет указанного ключа, возвращается Optional, содержащий false. Этот метод должен вызываться на потоке приложения JavaFX.
Параметры:
keyCode - KeyCode состояния блокировки для запроса
Возвращает:
состояние блокировки ключа, соответствующего keyCode, или пустой Optional, если система не может определить его состояние
Исключения:
IllegalArgumentException - если keyCode не является одним из допустимых значений KeyCode
IllegalStateException - если этот метод вызван на потоке, отличном от потока приложения JavaFX
С:
17

isNestedLoopRunning

public static boolean isNestedLoopRunning()
Проверяет, запущен ли вложенный цикл событий, возвращая true, если он есть, и false, если вложенных циклов событий в данный момент нет. Этот метод должен вызываться на потоке приложения JavaFX.
Возвращает:
true, если запущен вложенный цикл событий, и false в противном случае.
Исключения:
IllegalStateException - если этот метод вызван на потоке, отличном от потока приложения JavaFX.
С:
9

isAccessibilityActive

public static boolean isAccessibilityActive()
Получает значение свойства accessibilityActive.
Описание свойства:
Указывает, активна ли доступность. Это свойство, как правило, устанавливается в значение true в первый раз, когда технология вспомогательных средств, например, экранный диктор, запрашивает информацию о любом окне JavaFX или его дочерних элементах.

Этот метод может быть вызван с любого потока.

С:
JavaFX 8u40

accessibilityActiveProperty

public static ReadOnlyBooleanProperty accessibilityActiveProperty()
Указывает, активна ли доступность. Это свойство, как правило, устанавливается в значение true в первый раз, когда технология вспомогательных средств, например, экранный диктор, запрашивает информацию о любом окне JavaFX или его дочерних элементах.

Этот метод может быть вызван с любого потока.

С:
JavaFX 8u40
См. также:
isAccessibilityActive()

© 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