機械翻訳について

javafx.application

クラスApplication

java.lang.Object

javafx.application.Application

直系の既知のサブクラス:

Preloader

public abstract class Application
extends Object

JavaFXアプリケーションによる拡張元となるApplicationクラス

ライフサイクル

JavaFXアプリケーションのエントリ・ポイントはApplicationクラスです。 アプリケーションが起動されると常に、JavaFXランタイムにより次のことがこの順序で実行されます。

1. 指定されたApplicationクラスのインスタンスを構築します。
2. init()メソッドを呼び出します。
3. start(javafx.stage.Stage)メソッドを呼び出します。
4. 次のいずれかが発生した場合、アプリケーションの完了を待機します。
   • アプリケーションによりPlatform.exit()が呼び出される場合
   • 最後のウィンドウが閉じられ、かつPlatformのimplicitExit属性がtrueである場合
5. stop()メソッドを呼び出します。

startは抽象メソッドであり、オーバーライドされる必要があることに注意してください。 initメソッドとstopメソッドには、何も行わない具象実装があります。

JavaFXアプリケーションを明示的に終了するには、Platform.exit()を呼び出すことをお薦めします。 代替方法としてSystem.exit(int)を直接呼び出すことが許容されますが、Applicationはstop()メソッドを実行できなくなります。

JavaFXアプリケーションは、FXツールキットが終了した後、またはシャットダウンフックから(つまり、stop()メソッドが戻った後、またはSystem.exit(int)が呼び出された後に) JavaFXの使用を試みることはできません。

パラメータ

アプリケーションのパラメータは、init()メソッドからgetParameters()メソッドを呼び出して使用できるか、またはinitメソッドが呼び出された後にいつでも使用できます。

スレッド

JavaFXは、アプリケーションのstartメソッドの実行、入力イベントの処理、およびアニメーション・タイムラインの実行用のアプリケーション・スレッドを作成します。 JavaFXのSceneやStageオブジェクトの作成、およびライブ・オブジェクト(シーンにすでに接続されているオブジェクト)に対するシーン・グラフ操作の変更は、JavaFXアプリケーション・スレッドで実行される必要があります。

Java起動ツールは、JavaFXアプリケーション・スレッド上で指定されたApplicationクラスをロードおよび初期化します。 Applicationクラスにmainメソッドがない場合、またはmainメソッドがApplication.launch()を呼び出す場合は、ApplicationのインスタンスがJavaFXアプリケーション・スレッドに構築されます。

initメソッドは、JavaFXアプリケーション・スレッドではなく起動ツール・スレッドで呼び出されます。 これは、アプリケーションがinitメソッド内にSceneまたはStageを構築できないことを意味します。 アプリケーションは、initメソッド内に他のJavaFXオブジェクトを構築できます。

イベントのディスパッチ中、アニメーション・タイムラインの実行中、またはその他のコード中にJavaFXアプリケーション・スレッドで発生したすべての未処理例外は、スレッドのuncaught exception handlerに転送されます。

例

次の例は、単純なJavaFXアプリケーションを示しています。

import javafx.application.Application;
import javafx.scene.Group;
import javafx.scene.Scene;
import javafx.scene.shape.Circle;
import javafx.stage.Stage;

public class MyApp extends Application {
    public void start(Stage stage) {
        Circle circ = new Circle(40, 40, 30);
        Group root = new Group(circ);
        Scene scene = new Scene(root, 400, 300);

        stage.setTitle("My JavaFX Application");
        stage.setScene(scene);
        stage.show();
    }
}
 

この例では次が生成されます。

導入されたバージョン:

JavaFX 2.0

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラスと説明
static class	Application.Parameters アプリケーションのパラメータのセットをカプセル化します。

フィールドのサマリー

フィールド

修飾子と型	フィールドと説明
static String	STYLESHEET_CASPIAN Caspianテーマのユーザー・エージェント・スタイルシートの定数。
static String	STYLESHEET_MODENA Modenaテーマのユーザー・エージェント・スタイルシートの定数。

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
Application() 新規Applicationインスタンスを構築します。

メソッドのサマリー

修飾子と型	メソッドと説明
HostServices	getHostServices() このアプリケーションのHostServicesプロバイダを取得します。
Application.Parameters	getParameters() このアプリケーションのパラメータ(コマンドラインで渡された引数、およびアプレットやWebStartアプリケーションのJNLPファイルで指定されたパラメータを含む)を取得します。
static String	getUserAgentStylesheet() アプリケーション全体で使用されるユーザー・エージェント・スタイルシートを取得します。
void	init() アプリケーション初期化メソッド。
static void	launch(Class<? extends Application> appClass, String... args) スタンドアロン・アプリケーションを起動します。
static void	launch(String... args) スタンドアロン・アプリケーションを起動します。
void	notifyPreloader(Preloader.PreloaderNotification info) アプリケーション生成通知を使用してプレローダーに通知します。
static void	setUserAgentStylesheet(String url) アプリケーション全体で使用されるユーザー・エージェント・スタイルシートを設定します。
abstract void	start(Stage primaryStage) すべてのJavaFXアプリケーションのメイン・エントリ・ポイント。
void	stop() このメソッドは、アプリケーションの停止が必要な場合に呼び出され、アプリケーションが終了してリソースを破棄するための準備をする都合のよい機会を提供します。

クラス java.lang.Objectから継承されたメソッド

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

フィールドの詳細

STYLESHEET_CASPIAN

public static final String STYLESHEET_CASPIAN

Caspianテーマのユーザー・エージェント・スタイルシートの定数。 Caspianは、JavaFX 2.xでデフォルトとして提供されていたテーマです。

導入されたバージョン:

JavaFX 8.0

関連項目:

定数フィールド値

STYLESHEET_MODENA

public static final String STYLESHEET_MODENA

Modenaテーマのユーザー・エージェント・スタイルシートの定数。 Modenaは、JavaFX 8.xのデフォルト・テーマです。

導入されたバージョン:

JavaFX 8.0

関連項目:

定数フィールド値

コンストラクタの詳細

Application

public Application()

新規Applicationインスタンスを構築します。

メソッドの詳細

launch

public static void launch(Class<? extends Application> appClass,
                          String... args)

スタンドアロン・アプリケーションを起動します。 このメソッドは、通常、main()メソッドから呼び出されます。 複数回呼び出すことはできず、複数回呼び出した場合は例外がスローされます。

launchメソッドは、Platform.exitを呼び出すか、すべてのアプリケーション・ウィンドウを閉じてアプリケーションが終了するまで戻ってきません。

一般的な使用方法は次のとおりです。

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

ここで、MyAppはApplicationのサブクラスです。

パラメータ:

appClass - 起動ツールによって構築および実行されるアプリケーション・クラス。

args - アプリケーションに渡されるコマンドライン引数。 アプリケーションは、getParameters()メソッドを使用してこれらのパラメータを取得できます。

例外:

IllegalStateException - このメソッドが2回以上呼び出された場合。

IllegalArgumentException - appClassがApplicationのサブクラスでない場合。

launch

public static void launch(String... args)

スタンドアロン・アプリケーションを起動します。 このメソッドは、通常、main()メソッドから呼び出されます。 複数回呼び出すことはできず、複数回呼び出した場合は例外がスローされます。 これはlaunch(TheClass.class, args)と同等で、この場合、TheClassは、launchを呼び出したメソッドを直接包含するクラスです。 Applicationのサブクラスである必要があり、そうでない場合はRuntimeExceptionがスローされます。

launchメソッドは、Platform.exitを呼び出すか、すべてのアプリケーション・ウィンドウを閉じてアプリケーションが終了するまで戻ってきません。

一般的な使用方法は次のとおりです。

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

パラメータ:

args - アプリケーションに渡されるコマンドライン引数。 アプリケーションは、getParameters()メソッドを使用してこれらのパラメータを取得できます。

例外:

IllegalStateException - このメソッドが2回以上呼び出された場合。

init

public void init()
          throws Exception

アプリケーション初期化メソッド。 このメソッドは、Applicationクラスがロードおよび構築された直後に呼び出されます。 アプリケーションは、このメソッドをオーバーライドして、アプリケーションを実際に起動する前に初期化を実行できます。

Applicationクラスで提供されるこのメソッドの実装では何も行いません。

ノート: このメソッドはJavaFXアプリケーション・スレッドでは呼び出されません。 アプリケーションは、このメソッド内でSceneまたはStageを構築できません。 アプリケーションは、このメソッド内でその他のJavaFXオブジェクトを構築できます。

例外:

Exception

start

public abstract void start(Stage primaryStage)
                    throws Exception

すべてのJavaFXアプリケーションのメイン・エントリ・ポイント。 startメソッドは、initメソッドが戻った後、およびシステムでアプリケーションの実行開始の準備が整った後に呼び出されます。

ノート: このメソッドはJavaFXアプリケーション・スレッドで呼び出されます。

パラメータ:

primaryStage - アプリケーション・シーンを設定できる、このアプリケーションのプライマリ・ステージ。 プライマリ・ステージは、アプリケーションがアプレットとして起動された場合はブラウザに埋め込まれます。 アプリケーションは、必要な場合は他のステージを作成できますが、それらはプライマリ・ステージではなく、ブラウザに埋め込まれません。

例外:

Exception

stop

public void stop()
          throws Exception

このメソッドは、アプリケーションの停止が必要な場合に呼び出され、アプリケーションが終了してリソースを破棄するための準備をする都合のよい機会を提供します。

Applicationクラスで提供されるこのメソッドの実装では何も行いません。

ノート: このメソッドはJavaFXアプリケーション・スレッドで呼び出されます。

例外:

Exception

getHostServices

public final HostServices getHostServices()

このアプリケーションのHostServicesプロバイダを取得します。 このアプリケーションのコード・ベースおよびドキュメント・ベースを取得する機能、および包含Webページにアクセスする機能を提供します。

戻り値:

HostServicesプロバイダ

getParameters

public final Application.Parameters getParameters()

このアプリケーションのパラメータ(コマンドラインで渡された引数、およびアプレットやWebStartアプリケーションのJNLPファイルで指定されたパラメータを含む)を取得します。

ノート: nullが返されるため、このメソッドをApplicationコンストラクタから呼び出さないでください。 init()メソッドで呼び出すか、またはその後いつでも呼び出すことができます。

戻り値:

このアプリケーションのパラメータ、またはコンストラクタから呼び出された場合はnull。

notifyPreloader

public final void notifyPreloader(Preloader.PreloaderNotification info)

アプリケーション生成通知を使用してプレローダーに通知します。 アプリケーション・コードは、プレローダーのPreloader.handleApplicationNotificationメソッドに配信されるPreloaderNotificationを指定して、このメソッドを呼び出します。 これは、主に、長時間のアプリケーション初期化ステップ中にプレローダーで進捗を表示する必要があるアプリケーションの場合に有用です。

ノート: 通知はプレローダーのhandleApplicationNotification()メソッドにのみ配信されるため、つまり、このメソッドをProgressNotificationで呼び出す場合、Preloader.handleProgressNotificationメソッドには配信されません。

パラメータ:

info - アプリケーション生成プレローダー通知

getUserAgentStylesheet

public static String getUserAgentStylesheet()

アプリケーション全体で使用されるユーザー・エージェント・スタイルシートを取得します。 すべてのUIコントロールおよびその他のノードのデフォルトのスタイルを提供するために使用されます。 値にnullを指定すると、プラットフォームのデフォルトのスタイルシートが使用されます。

ノート: このメソッドはJavaFXアプリケーション・スレッドで呼び出される必要があります。

戻り値:

文字列としてのスタイルシートへのURL。

導入されたバージョン:

JavaFX 8.0

setUserAgentStylesheet

public static void setUserAgentStylesheet(String url)

アプリケーション全体で使用されるユーザー・エージェント・スタイルシートを設定します。 すべてのUIコントロールおよびその他のノードのデフォルトのスタイルを提供するために使用されます。 JavaFXの各リリースにはこれに対して新しいデフォルト値が存在する可能性があるため、整合性を保証する必要がある場合は、このメソッドを呼び出して、アプリケーションに使用するデフォルトを選択する必要があります。 値にnullを指定すると、プラットフォームのデフォルトのスタイルシートが復元されます。 このプロパティは、-Djavafx.userAgentStylesheetUrl=[URL]を使用してコマンドラインで設定することもできます。コマンドラインで設定すると、コードのこのメソッドを使用して設定したすべてのものがオーバーライドされます。

ノート: このメソッドはJavaFXアプリケーション・スレッドで呼び出される必要があります。

パラメータ:

url - 文字列としてのスタイルシートへのURL。

導入されたバージョン:

JavaFX 8.0