モジュール javafx.graphics
パッケージ javafx.application

クラスPlatform


  • public final class Platform
extends Object
    アプリケーション・プラットフォーム・サポート・クラス。
    導入されたバージョン:
    JavaFX 2.0

    • メソッドのサマリー

      すべてのメソッド 静的メソッド 具象メソッド 
      修飾子と型 メソッド 説明
      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​()
      呼出し側スレッドがJavaFXアプリケーション・スレッドである場合にtrueを返します。
      static boolean isImplicitExit​()
      implicitExit属性の値を取得します。
      static boolean isNestedLoopRunning​()
      ネストされたイベント・ループが実行されているかどうかをチェックし、存在することを示すtrueを返します。現在実行中のネストされたイベント・ループがない場合はfalseを返します。
      static boolean isSupported​(ConditionalFeature feature)
      条件付き機能がプラットフォームでサポートされているかどうかを問い合せます。
      static void requestNextPulse​()
      Java Runtimeにパルスを実行するようにリクエストします。
      static void runLater​(Runnable runnable)
      JavaFXアプリケーション・スレッドで指定されたRunnableを将来のある時間に実行します。
      static void setImplicitExit​(boolean implicitExit)
      implicitExit属性を指定された値に設定します。
      static void startup​(Runnable runnable)
      このメソッドは、JavaFXランタイムを開始します。

    • プロパティの詳細

      • accessibilityActive

        public static ReadOnlyBooleanProperty accessibilityActiveProperty
        アクセシビリティがアクティブかどうかを示します。 このプロパティは、スクリーン・リーダーなどの補助テクノロジが、初回にいずれかのJavaFXウィンドウまたはその子に関する情報を要求する際、一般的にtrueに設定されます。

        このメソッドは、任意のスレッドから呼び出すことができます。

        導入されたバージョン:
        JavaFX 8u40
        関連項目:
        isAccessibilityActive()

    • メソッドの詳細

      • startup

        public static void startup​(Runnable runnable)
        このメソッドは、JavaFXランタイムを開始します。 指定されたRunnableはJavaFXアプリケーション・スレッドで呼び出されます。 一般に、このメソッドを明示的に呼び出す必要はありません。なぜなら、このメソッドは、ほとんどのJavaFXアプリケーションの構築方法の結果として呼び出されるからです。 しかし、このメソッドを直接呼び出すための有効なユースケースがあります。 このメソッドはJavaFXランタイムを開始するため、JavaFXアプリケーション・スレッドはまだ存在しないため、このメソッドはアプリケーションのメイン・スレッドで直接呼び出されるのが普通です。

        このメソッドは、指定されたRunnableのrunメソッドが呼び出される前に、呼び出し元に返される場合とされない場合があります。 いずれにしても、このメソッドが戻ったら、追加のRunnablesでrunLater(Runnable)を呼び出すことができます。 これらのRunnableは、このメソッドに渡されたRunnableが呼び出された後、JavaFXアプリケーション・スレッドでも呼び出されます。

        前述したように、通常はJavaFXアプリケーション・スレッドが自動的に起動されます。 このメソッドは、JavaFXランタイムがまだ初期化されていない場合にのみ呼び出されることが重要です。 JavaFXランタイムが自動的に開始される状況は次のとおりです:

        • Applicationを拡張し、JavaランチャまたはApplicationクラスの起動メソッドのいずれかを使用してアプリケーションを起動する標準のJavaFXアプリケーションの場合、FXランタイムはApplicationクラスがロードされる前にランチャによって自動的に初期化されます。
        • FXコンテンツを表示するためにJFXPanelを使用するSwingアプリケーションでは、最初のJFXPanelインスタンスの構築時にFXランタイムが初期化されます。
        • FXコンテンツを表示するためにFXCanvasを使用するSWTアプリケーションでは、最初のFXCanvasインスタンスの構築時にFXランタイムが初期化されます。

        アプリケーションがこれらの一般的なアプローチに従わない場合、この起動メソッドを呼び出すことによってJavaFXランタイムを手動で起動するのは開発者の責任となります。

        JavaFXランタイムがすでに実行されているときにこのメソッドを呼び出すと、IllegalStateExceptionがスローされます - JavaFXランタイムを一度起動するようにリクエストすることは有効です。

        パラメータ:
        runnable - 実行されたJavaFXアプリケーション・スレッドでrunメソッドが実行されるRunnable
        例外:
        IllegalStateException - JavaFXランタイムがすでに実行中の場合
        導入されたバージョン:
        9
        関連項目:
        Application

      • runLater

        public static void runLater​(Runnable runnable)
        JavaFXアプリケーション・スレッドで指定されたRunnableを将来のある時間に実行します。 任意のスレッドから呼び出すことができるこのメソッドは、Runnableをイベント・キューに転送して、呼出し元にすぐに戻ります。 Runnableは、転送された順序で実行されます。 runLaterメソッドに渡されたRunnableは、runLaterへの後続の呼出しに渡されたすべてのRunnableの前に実行されます。 JavaFXランタイムが停止した後にこのメソッドが呼び出された場合、その呼出しは無視されます。つまり、Runnableは実行されず、例外はスローされません。

        注意: アプリケーションが、多すぎる保留中RunnableをJavaFXに送らないようにする必要があります。 そうしないと、アプリケーションが応答しなくなる可能性があります。 アプリケーションでは、複数の操作を、少ない数のrunLater呼出しにまとめることが推奨されています。 さらに、長時間実行される操作は可能な場合はバックグラウンド・スレッドで実行し、GUI操作のためにJavaFXアプリケーション・スレッドを解放する必要があります。

        このメソッドは、FXランタイムが初期化される前に呼び出さないでください。 Applicationを拡張し、アプリケーションの起動にJava起動ツール、またはApplicationクラスのいずれかのlaunchメソッドを使用する標準のJavaFXアプリケーションの場合、FXランタイムはApplicationクラスがロードされる前に起動ツールによって初期化されます。 FXコンテンツの表示にJFXPanelを使用するSwingアプリケーションの場合、FXランタイムは最初のJFXPanelインスタンスの構築時に初期化されます。 FXコンテンツの表示にFXCanvasを使用するSWTアプリケーションの場合、FXランタイムは最初のFXCanvasインスタンスの構築時に初期化されます。 これらのアプローチに従わないアプリケーションでは、startup(Runnable)を一度呼び出すことによってJavaFXランタイムを手動で起動する必要があります。

        パラメータ:
        runnable - runメソッドがJavaFXアプリケーション・スレッドで実行されるRunnable
        例外:
        IllegalStateException - FXランタイムが初期化されていない場合
        関連項目:
        Application

      • requestNextPulse

        public static void requestNextPulse​()
        Java Runtimeにパルスを実行するようにリクエストします。 アニメーション・タイマー、シーン・グラフの変更、またはパルスが実行されるウィンドウ・イベントがない場合でも、これはパルスを実行します。 進行中の脈拍がない場合、次に脈拍タイマーが発動したときに脈拍が実行されるようにスケジュールされます。 既にパルスが実行されている場合、現在のパルスの後に少なくとも1つのさらなるパルスがスケジュールされる。 このメソッドは、任意のスレッドで呼び出すことができます。
        導入されたバージョン:
        9

      • isFxApplicationThread

        public static boolean isFxApplicationThread​()
        呼出し側スレッドがJavaFXアプリケーション・スレッドである場合にtrueを返します。 この呼出しを使用して、指定されたタスクがJavaFXアプリケーション・スレッドで確実に実行される(または実行されない)ようにします。
        戻り値:
        JavaFXアプリケーション・スレッドで実行する場合はtrue

      • exit

        public static void exit​()
        JavaFXアプリケーションを終了します。 このメソッドがApplicationのstartメソッドが呼び出された後に呼び出されると、JavaFX起動ツールはApplicationのstopメソッドを呼び出して、JavaFXアプリケーション・スレッドを終了します。 その後、起動ツール・スレッドが停止します。 デーモン以外の他のスレッドで実行中のものがない場合は、Java VMが終了します。 このメソッドがPreloaderまたはApplicationのinitメソッドから呼び出された場合は、Applicationのstopメソッドを呼び出すことはできません。

        このメソッドは、任意のスレッドから呼び出すことができます。

        注意: アプリケーションがブラウザに埋め込まれている場合は、このメソッドによる影響はありません。

      • 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呼び出しが行われるまでブロックします。 このメソッドに渡されたキーは、一致する入力/出力のペアを一意に識別するために使用されます。 このメソッドは新しいネストされたイベント・ループを作成し、対応するexitNestedEventLoopメソッドが同じキーで呼び出されるまでブロックします。 このメソッドの戻り値は、そのブロックを解除するexitNestedEventLoopメソッド呼び出しに提供されたrvalオブジェクトになります。

        このメソッドは、入力イベント・ハンドラまたはPlatform.runLaterに渡されたRunnableのrunメソッドから呼び出される必要があります。 アニメーションやレイアウトの処理中に呼び出されてはなりません。

        パラメータ:
        key - ネストされたイベント・ループを識別するObject。ヌルであってはならない
        戻り値:
        exitEventLoopへの対応する呼び出しに渡された値
        例外:
        IllegalArgumentException - 指定されたキーが、まだ返されていないネストされたイベント・ループに関連付けられている場合
        NullPointerException - keyがnullの場合
        IllegalStateException - このメソッドがアニメーションまたはレイアウト処理中に呼び出された場合。
        IllegalStateException - このメソッドがJavaFXアプリケーション・スレッド以外のスレッドで呼び出された場合。
        導入されたバージョン:
        9

      • exitNestedEventLoop

        public static void exitNestedEventLoop​(Object key,
                                       Object rval)
        ネストされたイベント・ループを終了し、対応するenterNestedEventLoopの呼び出し元のブロックを解除します。 このメソッドに渡されたキーは、一致する入力/出力のペアを一意に識別するために使用されます。 このメソッドは、キーで以前に作成されたネストされたイベント・ループを終了させ、コントロールを呼び出し元に返します。 指定されたネストされたイベント・ループが最も内側のループでない場合、他のすべての内部ループも終了するまで戻りません。
        パラメータ:
        key - ネストされたイベント・ループを識別するObject。ヌルであってはならない
        rval - 対応するenterNestedEventLoopの呼び出し側に返されるObject。 nullも指定できます。
        例外:
        IllegalArgumentException - 指定されたキーがアクティブなネストされたイベント・ループに関連付けられていない場合
        NullPointerException - keyがnullの場合
        IllegalStateException - このメソッドがFXアプリケーション・スレッド以外のスレッドで呼び出された場合
        導入されたバージョン:
        9

      • isNestedLoopRunning

        public static boolean isNestedLoopRunning​()
        ネストされたイベント・ループが実行されているかどうかをチェックし、存在することを示すtrueを返します。現在実行中のネストされたイベント・ループがない場合はfalseを返します。 このメソッドは、JavaFXアプリケーション・スレッドで呼び出される必要があります。
        戻り値:
        ネストされたイベント・ループが実行されている場合はtrue、そうでない場合はfalse。
        例外:
        IllegalStateException - このメソッドがJavaFXアプリケーション・スレッド以外のスレッドで呼び出された場合。
        導入されたバージョン:
        9

      • isAccessibilityActive

        public static boolean isAccessibilityActive​()
        プロパティaccessibilityActiveの値を取得します。
        プロパティの説明:
        アクセシビリティがアクティブかどうかを示します。 このプロパティは、スクリーン・リーダーなどの補助テクノロジが、初回にいずれかのJavaFXウィンドウまたはその子に関する情報を要求する際、一般的にtrueに設定されます。

        このメソッドは、任意のスレッドから呼び出すことができます。

        導入されたバージョン:
        JavaFX 8u40

      • accessibilityActiveProperty

        public static ReadOnlyBooleanProperty accessibilityActiveProperty​()
        アクセシビリティがアクティブかどうかを示します。 このプロパティは、スクリーン・リーダーなどの補助テクノロジが、初回にいずれかのJavaFXウィンドウまたはその子に関する情報を要求する際、一般的にtrueに設定されます。

        このメソッドは、任意のスレッドから呼び出すことができます。

        導入されたバージョン:
        JavaFX 8u40
        関連項目:
        isAccessibilityActive()