モジュール javafx.graphics
パッケージ javafx.scene.text

クラスFont


  • public final class Font
extends Object

    Fontクラスは、テキストを画面上にレンダリングするために使用されるフォントを表します。

    Fontのサイズはポイント(実世界では約1/72インチ)で指定するようになっています。

    Fontとその祖先を使用して、Nodeの変換属性によって決定されたレンダリング変換によってフォントがスケーリングされる場合、サイズは実際にはノードのローカル座標空間に対して相対的になります。ノードの環境にスケーリング変換が存在しない場合は、ポイントのサイズに似た座標が提供されます。 デフォルト座標系で指定された実世界の距離は、単に、経験則でポイント・サイズに近似させたものとなり、一般的には、ほとんどのディスプレイにおいてデフォルトで画面ピクセルが使用されることに注意してください。

    デフォルト座標系の詳細は、Nodeを参照してください。

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

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

      コンストラクタ 
      コンストラクタ 説明
      Font​(double size)
      デフォルトのフェイスSystemを使用したフォントを構築します。
      Font​(String name, double size)
      指定された完全なフェイス名とサイズを使用したフォントを構築します。

    • メソッドのサマリー

      すべてのメソッド 静的メソッド インスタンス・メソッド 具象メソッド 
      修飾子と型 メソッド 説明
      boolean equals​(Object obj)
      このオブジェクトと他のオブジェクトが等しいかどうかを示します。
      static Font font​(double size)
      デフォルトのフォント・ファミリ名と指定されたフォント・サイズに基づいて適切なフォントを検索します。
      static Font font​(String family)
      指定されたフォント・ファミリ名とデフォルトのフォント・サイズに基づいて適切なフォントを検索します。
      static Font font​(String family, double size)
      フォント・ファミリ名とサイズに基づいて適切なフォントを検索します。
      static Font font​(String family, FontPosture posture, double size)
      フォント・ファミリ名とポスチャ・スタイルに基づいて適切なフォントを検索します。
      static Font font​(String family, FontWeight weight, double size)
      フォント・ファミリ名と太さスタイルに基づいて適切なフォントを検索します。
      static Font font​(String family, FontWeight weight, FontPosture posture, double size)
      フォント・ファミリ名、太さスタイルおよびポスチャ・スタイルに基づいて適切なフォントを検索します。
      static Font getDefault​()
      デフォルト・フォントを取得します。デフォルト・フォントのファミリはSystem、スタイルは通常はRegularとなり、サイズについては、判断可能な範囲においてユーザーのデスクトップ環境と一致するものが取得されます。
      static List<String> getFamilies​()
      アプリケーション・フォントやSDKフォントを含め、ユーザーのシステムにインストールされているすべてのフォント・ファミリを取得します。
      String getFamily​()
      このフォントのファミリを返します。
      static List<String> getFontNames​()
      アプリケーション・フォントやSDKフォントを含め、ユーザーのシステムにインストールされているすべてのフォントの名前を取得します。
      static List<String> getFontNames​(String family)
      アプリケーション・フォントやSDKフォントを含め、ユーザーのシステムにインストールされている特定のフォント・ファミリに属するすべてのフォントの名前を取得します。
      String getName​()
      完全なフォント名。
      double getSize​()
      このフォントのポイント・サイズ。
      String getStyle​()
      フォント・ファミリ内のフォントのスタイルを表す特定の文字列。
      int hashCode​()
      このFontオブジェクトのハッシュ・コードを返します。
      static Font loadFont​(InputStream in, double size)
      指定された入力ストリームからフォント・リソースをロードします。
      static Font loadFont​(String urlStr, double size)
      指定されたURLからフォント・リソースをロードします。
      static Font[] loadFonts​(InputStream in, double size)
      指定された入力ストリームからフォント・リソースを読み込みます。
      static Font[] loadFonts​(String urlStr, double size)
      指定されたURLからフォント・リソースを読み込みます。
      String toString​()
      このFontオブジェクトをString表現に変換します。

    • コンストラクタの詳細

      • Font

        public Font​(double size)
        デフォルトのフェイスSystemを使用したフォントを構築します。 基礎となるフォントは、現在のUI環境の一般的なUIフォントに基づき、実装によって決定されます。
        パラメータ:
        size - 使用するフォント・サイズ

      • Font

        public Font​(String name,
            double size)
        指定された完全なフェイス名とサイズを使用したフォントを構築します。
        パラメータ:
        name - 完全なフォント名。
        size - 使用するフォント・サイズ

    • メソッドの詳細

      • getDefault

        public static Font getDefault​()
        デフォルト・フォントを取得します。デフォルト・フォントのファミリはSystem、スタイルは通常はRegularとなり、サイズについては、判断可能な範囲においてユーザーのデスクトップ環境と一致するものが取得されます。
        戻り値:
        デフォルト・フォント。

      • getFamilies

        public static List<String> getFamilies​()
        アプリケーション・フォントやSDKフォントを含め、ユーザーのシステムにインストールされているすべてのフォント・ファミリを取得します。 初回はすべてのフォントを参照することで、負荷がかかる操作となる可能性があるため、この呼出しについてはパフォーマンスを考慮する必要があります。
        戻り値:
        使用可能なすべてのフォント・ファミリを含むリスト。

      • getFontNames

        public static List<String> getFontNames​()
        アプリケーション・フォントやSDKフォントを含め、ユーザーのシステムにインストールされているすべてのフォントの名前を取得します。 初回はすべてのフォントを参照することで、負荷がかかる操作となる可能性があるため、この呼出しについてはパフォーマンスを考慮する必要があります。
        戻り値:
        使用可能なすべてのフォントを含むリスト。

      • getFontNames

        public static List<String> getFontNames​(String family)
        アプリケーション・フォントやSDKフォントを含め、ユーザーのシステムにインストールされている特定のフォント・ファミリに属するすべてのフォントの名前を取得します。 初回はすべてのフォントを参照することで、負荷がかかる操作となる可能性があるため、この呼出しについてはパフォーマンスを考慮する必要があります。
        パラメータ:
        family - フォント・ファミリ
        戻り値:
        指定されたファミリのフォントを含むリスト。

      • font

        public static Font font​(String family,
                        FontWeight weight,
                        FontPosture posture,
                        double size)
        フォント・ファミリ名、太さスタイルおよびポスチャ・スタイルに基づいて適切なフォントを検索します。 このメソッドは、特定のフォントを返すことは保証されていませんが、指定された要件に最も適合するフォントを検索する場合に適しています。

        ファミリの値をnullまたは空にした場合は、実装によってなんらかの適切なフォントが選択されます。

        パラメータ:
        family - フォントのファミリ
        weight - フォントの太さ
        posture - ポスチャまたはフォントのポスチャ
        size - フォントのポイント・サイズ 小数値にはできますが、負にはできません。 サイズが< 0の場合、デフォルトのサイズが使用されます。
        戻り値:
        指定された要件に最も適合するフォント。

      • font

        public static Font font​(String family,
                        FontWeight weight,
                        double size)
        フォント・ファミリ名と太さスタイルに基づいて適切なフォントを検索します。 このメソッドは、特定のフォントを返すことは保証されていませんが、指定された要件に最も適合するフォントを検索する場合に適しています。 ファミリの値をnullまたは空にした場合は、実装によってなんらかの適切なフォントが選択されます。
        パラメータ:
        family - フォントのファミリ
        weight - フォントの太さ
        size - フォントのポイント・サイズ 小数値にはできますが、負にはできません。 サイズが< 0の場合、デフォルトのサイズが使用されます。
        戻り値:
        指定された要件に最も適合するフォント。

      • font

        public static Font font​(String family,
                        FontPosture posture,
                        double size)
        フォント・ファミリ名とポスチャ・スタイルに基づいて適切なフォントを検索します。 このメソッドは、特定のフォントを返すことは保証されていませんが、指定された要件に最も適合するフォントを検索する場合に適しています。 ファミリの値をnullまたは空にした場合は、実装によってなんらかの適切なフォントが選択されます。
        パラメータ:
        family - フォントのファミリ
        posture - ポスチャまたはフォントのポスチャ
        size - フォントのポイント・サイズ 小数値にはできますが、負にはできません。 サイズが< 0の場合、デフォルトのサイズが使用されます。
        戻り値:
        指定された要件に最も適合するフォント。

      • font

        public static Font font​(String family,
                        double size)
        フォント・ファミリ名とサイズに基づいて適切なフォントを検索します。 このメソッドは、特定のフォントを返すことは保証されていませんが、指定された要件に最も適合するフォントを検索する場合に適しています。 ファミリの値をnullまたは空にした場合は、実装によってなんらかの適切なフォントが選択されます。
        パラメータ:
        family - フォントのファミリ
        size - フォントのポイント・サイズ 小数値にはできますが、負にはできません。 サイズが< 0の場合、デフォルトのサイズが使用されます。
        戻り値:
        指定された要件に最も適合するフォント。

      • font

        public static Font font​(String family)
        指定されたフォント・ファミリ名とデフォルトのフォント・サイズに基づいて適切なフォントを検索します。 このメソッドは、特定のフォントを返すことは保証されていませんが、指定された要件に最も適合するフォントを検索する場合に適しています。 ファミリの値をnullまたは空にした場合は、実装によってなんらかの適切なフォントが選択されます。
        パラメータ:
        family - フォントのファミリ
        戻り値:
        指定された要件に最も適合するフォント。

      • font

        public static Font font​(double size)
        デフォルトのフォント・ファミリ名と指定されたフォント・サイズに基づいて適切なフォントを検索します。 このメソッドは、特定のフォントを返すことは保証されていませんが、指定された要件に最も適合するフォントを検索する場合に適しています。
        パラメータ:
        size - フォントのポイント・サイズ 小数値にはできますが、負にはできません。 サイズが< 0の場合、デフォルトのサイズが使用されます。
        戻り値:
        指定された要件に最も適合するフォント。

      • getName

        public final String getName​()
        完全なフォント名。 この名前には、ファミリ名とそのファミリ内のスタイル・バリアントの両方が含まれています。 たとえば、プレーンのArialフォントの場合はArial Regularになり、太字のArialフォントの場合はArial Boldになります。 フォントのロード時に使用する正確な名前は、完全なフォント名と同様に各フォント・ファイル内に定義されています。 たとえば、Proxima Nova ExtraCondensed Bold Italicは特定のProxima Novaフォントを表します。 名前をnullまたは空にした場合は、実装によってなんらかの適切なフォントが選択されます。

        1つの統合された方法を使用して、アプリケーションによって指定されているフォント(Font.loadFont()を使用)、JavaFXランタイムに付属のフォントおよびシステムにインストールされているフォントをすべてロードできます。 ロード対象のフォントの完全な名前を指定すると、単にフォントが作成されます。 特定のフォントが見つからない場合は、フォールバックまたはデフォルト・フォントが使用されます。 名前は、使用されるフォントの実際の名前を反映するように更新されます。 フォントの名前とロード試行した名前を照合することによって、ロード失敗条件を調べることができます。

        フォントをフォント・ファミリおよびスタイルで検索する場合は、このクラスに定義されているfont(java.lang.String, javafx.scene.text.FontWeight, javafx.scene.text.FontPosture, double)ファクトリ・メソッドのいずれかを使用できます。

        デフォルト値:
        空の文字列
        戻り値:
        完全なフォント名

      • getFamily

        public final String getFamily​()
        このフォントのファミリを返します。
        戻り値:
        このフォントのファミリ。

      • getStyle

        public final String getStyle​()
        フォント・ファミリ内のフォントのスタイルを表す特定の文字列。
        戻り値:
        このフォントのスタイル名。

      • getSize

        public final double getSize​()
        このフォントのポイント・サイズ。 11.5などの小数値になることもあります。 指定された値が< 0の場合、デフォルトのサイズが使用されます。
        デフォルト値:
        12
        戻り値:
        このフォントのポイント・サイズ

      • loadFont

        public static Font loadFont​(String urlStr,
                            double size)
        指定されたURLからフォント・リソースをロードします。 ロードが成功し、場所が読取り可能で、サポートされているフォント書式を表している場合は、Fontオブジェクトが返されます。

        セキュリティ・マネージャが存在する場合、アプリケーションは指定されたURLロケーションからの読み取り許可とFXPermission "loadFont"の両方を持っていなければなりません。 アプリケーションに指定されたURLのロケーションから読み取る権限がない場合は、nullが戻されます。 アプリケーションに"loadFont"アクセス権がない場合、このメソッドは指定されたフォント・サイズのデフォルト・システム・フォントを返します。

        URLの形式が誤っているために、移動やリソースからの読取りができない場合、またはフォントが表現されない場合など、失敗すると、nullが返されます。 使用する前に、アプリケーションでこのことをチェックする必要があります。

        成功してnull以外が返された場合は、使用可能なコンストラクタおよびファクトリ・メソッドによって作成できるように、FXグラフィックス・システムにフォントが登録されます。フォントのダウンロードとインストールのオーバーヘッドが繰り返されないように、アプリケーションでは、このメソッドを再度呼び出すのではなく、この方法でフォントを使用する必要があります。

        フォントのsizeパラメータを使用すると、一般的な使用方法において、返された(null以外の)フォントをアプリケーションで直接使用でき、コンストラクタ経由で作成する必要がないため便利です。 無効なサイズは<= 0でデフォルト・サイズになります。

        URLがローカル・ディスク・ファイルを表す場合、コピーは実行されないため、アプリケーションの存続期間中、フォント・ファイルを維持する必要があります。 なんらかの方法でファイルを更新すると、指定されていない、望ましくない動作が発生する場合があります。

        パラメータ:
        urlStr - フォントのロード元を表す文字列。
        size - 返されたフォントのサイズ。
        戻り値:
        フォント、またはnull (フォントを作成できない場合)。

      • loadFonts

        public static Font[] loadFonts​(String urlStr,
                               double size)
        指定されたURLからフォント・リソースを読み込みます。 ロードが成功してそのロケーションが読み取り可能であり、サポートされているフォント形式を表す場合、Fontの配列が返されます。

        このメソッドのユースケースは、TrueType Collection (TTC)からすべてのフォントをロードするためのものです。

        セキュリティ・マネージャが存在する場合、アプリケーションは指定されたURLロケーションからの読み取り許可とFXPermission "loadFont"の両方を持っていなければなりません。 アプリケーションに指定されたURLのロケーションから読み取る権限がない場合は、nullが戻されます。 アプリケーションに"loadFont"アクセス権がない場合、このメソッドは、指定されたフォント・サイズを持つデフォルトのシステム・フォントである1つの要素の配列を返します。

        URLの形式が誤っているために、移動やリソースからの読取りができない場合、またはフォントが表現されない場合など、失敗すると、nullが返されます。 使用する前に、アプリケーションでこのことをチェックする必要があります。

        (non-null)が正常に終了すると、使用可能なコンストラクタとファクトリ・メソッドによって作成されるフォントがFXグラフィック・スシステムに登録され、アプリケーションはこのメソッドを再度呼び出すのではなく、この方法で使用する必要があります。フォント。

        フォントのsizeパラメータを使用すると、一般的な使用方法において、返された(null以外の)フォントをアプリケーションで直接使用でき、コンストラクタ経由で作成する必要がないため便利です。 無効なサイズは<= 0でデフォルト・サイズになります。

        URLがローカル・ディスク・ファイルを表す場合、コピーは実行されないため、アプリケーションの存続期間中、フォント・ファイルを維持する必要があります。 なんらかの方法でファイルを更新すると、指定されていない、望ましくない動作が発生する場合があります。

        パラメータ:
        urlStr - Stringを指定してフォントをロードします。
        size - 返されるフォントの。
        戻り値:
        Fontの配列。フォントを作成できない場合はnull。
        導入されたバージョン:
        9

      • loadFont

        public static Font loadFont​(InputStream in,
                            double size)
        指定された入力ストリームからフォント・リソースをロードします。 ロードが成功し、ストリームが完全に読取り可能で、サポートされているフォント書式を表している場合は、Fontオブジェクトが返されます。

        セキュリティ・マネージャが存在する場合、アプリケーションにはFXPermission "loadFont"が必要です。 アプリケーションにアクセス権がない場合、このメソッドは指定されたフォント・サイズのデフォルト・システム・フォントを返します。

        省略形の入力が使用されるか、フォント書式がサポートされていないことなどが原因でロードに失敗すると、nullが返されます。 使用する前に、アプリケーションでこのことをチェックする必要があります。

        成功してnull以外が返された場合は、使用可能なコンストラクタおよびファクトリ・メソッドによって作成できるように、FXグラフィックス・システムにフォントが登録されます。フォントの再読取りとインストールのオーバーヘッドが繰り返されないように、アプリケーションでは、このメソッドを再度呼び出すのではなく、この方法でフォントを使用する必要があります。

        フォントのsizeパラメータを使用すると、一般的な使用方法において、返された(null以外の)フォントをアプリケーションで直接使用でき、コンストラクタ経由で作成する必要がないため便利です。 無効なサイズは<= 0でデフォルト・サイズになります。

        このメソッドでは入力ストリームは閉じられません。

        パラメータ:
        in - フォントのロード元ストリーム。
        size - 返されたフォントのサイズ。
        戻り値:
        フォント、またはnull (フォントを作成できない場合)。

      • loadFonts

        public static Font[] loadFonts​(InputStream in,
                               double size)
        指定された入力ストリームからフォント・リソースを読み込みます。 ロードが成功してストリームが完全に読み取られ、サポートされているフォント・フォーマットを表す場合、Fontの配列が返されます。

        このメソッドのユースケースは、TrueType Collection (TTC)からすべてのフォントをロードするためのものです。

        セキュリティ・マネージャが存在する場合、アプリケーションにはFXPermission "loadFont"が必要です。 アプリケーションにアクセス権がない場合、このメソッドは指定されたフォント・サイズのデフォルト・システム・フォントを返します。

        省略形の入力が使用されるか、フォント書式がサポートされていないことなどが原因でロードに失敗すると、nullが返されます。 使用する前に、アプリケーションでこのことをチェックする必要があります。

        (non-null)が正常に終了すると、使用可能なコンストラクタとファクトリ・メソッドによって作成されるフォントがFXグラフィック・スシステムに登録され、アプリケーションはこのメソッドを再度呼び出すのではなく、この方法で使用する必要があります。フォントをインストールします。

        フォントsizeパラメータは便利なので、典型的な使用法では、アプリケーションはコンストラクタを介して再作成する必要はなく、返された(non-null)フォントを直接使用できます。 無効なサイズは<= 0でデフォルト・サイズになります。

        このメソッドでは入力ストリームは閉じられません。

        パラメータ:
        in - フォントをロードするストリーム。
        size - 返されるフォントの。
        戻り値:
        Fontの配列。フォントを作成できない場合はnull。
        導入されたバージョン:
        9

      • toString

        public String toString​()
        このFontオブジェクトをString表現に変換します。 文字列表現は情報提供のみを目的としており、変化します。 この文字列表現をプログラミング用途で使用することは避けてください。
        オーバーライド:
        toString 、クラス:  Object
        戻り値:
        このオブジェクトの文字列表現

      • equals

        public boolean equals​(Object obj)
        このオブジェクトと他のオブジェクトが等しいかどうかを示します。
        オーバーライド:
        equals 、クラス:  Object
        パラメータ:
        obj - 比較対象の参照オブジェクト。
        戻り値:
        このオブジェクトがobj引数と等しい場合はtrue、そうでない場合はfalse。
        関連項目:
        Object.hashCode()、HashMap