Класс 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. |
Подробности свойства
accessibilityActive
public static ReadOnlyBooleanProperty accessibilityActiveProperty
Этот метод может быть вызван из любого потока.
- С:
- JavaFX 8u40
- См. также:
isAccessibilityActive()
Подробности метода
startup
public static void startup(Runnable runnable)
Этот метод может или не может вернуть управление вызывающей стороне до того, как будет вызван метод 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)
ПРИМЕЧАНИЕ: приложениям следует избегать перегрузки 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()
- С:
- 9
isFxApplicationThread
public static boolean isFxApplicationThread()
- Возвращает:
- true, если выполняется в потоке приложения JavaFX
exit
public static void exit()
Этот метод может быть вызван из любого потока.
setImplicitExit
public static void setImplicitExit(boolean implicitExit)
Application.stop() и завершит поток приложения JavaFX. Если этот атрибут равен false, приложение продолжит работу нормально даже после закрытия последнего окна, до тех пор, пока приложение не вызовет exit(). Значение по умолчанию — true. Этот метод может быть вызван из любого потока.
- Параметры:
-
implicitExit- флаг, указывающий, следует ли неявно завершать приложение при закрытии последнего окна. - С:
- JavaFX 2.2
isImplicitExit
public static boolean isImplicitExit()
Этот метод может быть вызван из любого потока.
- Возвращает:
- атрибут 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)
rval, переданный в вызов метода exitNestedEventLoop, который его разблокирует. Этот метод должен вызываться либо из обработчика событий ввода, либо из метода run Runnable, переданного в Platform.runLater. Он не должен вызываться во время анимации или обработки макета.
- Параметры:
-
key- объект, идентифицирующий вложенный цикл обработки событий, не может быть null - Возвращает:
- значение, переданное в соответствующий вызов exitEventLoop
- Исключения:
-
IllegalArgumentException- если указанный ключ связан с вложенным циклом обработки событий, который ещё не завершён -
NullPointerException- если ключ равен null -
IllegalStateException- если этот метод вызывается во время анимации или обработки макета. -
IllegalStateException- если этот метод вызывается в потоке, отличном от потока приложения JavaFX. - С:
- 9
Выход из вложенного цикла событий
public static void exitNestedEventLoop(Object key, Object rval)
- Параметры:
-
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 в противном случае.
- Исключения:
-
IllegalStateException- если этот метод вызван на потоке, отличном от потока приложения JavaFX. - С:
- 9
isAccessibilityActive
public static boolean isAccessibilityActive()
- Описание свойства:
- Указывает, активна ли доступность. Это свойство, как правило, устанавливается в значение true в первый раз, когда технология вспомогательных средств, например, экранный диктор, запрашивает информацию о любом окне JavaFX или его дочерних элементах.
Этот метод может быть вызван с любого потока.
- С:
- JavaFX 8u40
accessibilityActiveProperty
public static ReadOnlyBooleanProperty accessibilityActiveProperty()
Этот метод может быть вызван с любого потока.
- С:
- 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.