public final class Font extends Object
Font
クラスは、テキストを画面上にレンダリングするために使用されるフォントを表します。
Font
のサイズはポイント(実世界では約1/72インチ)で指定するようになっています。
Font
とその祖先を使用して、Node
の変換属性によって決定されたレンダリング変換によってフォントがスケーリングされる場合、サイズは実際にはノードのローカル座標空間に対して相対的になります。ノードの環境にスケーリング変換が存在しない場合は、ポイントのサイズに似た座標が提供されます。デフォルト座標系で指定された実世界の距離は、単に、経験則でポイント・サイズに近似させたものとなり、一般的には、ほとんどのディスプレイにおいてデフォルトで画面ピクセルが使用されることに注意してください。
デフォルト座標系の詳細は、Node
を参照してください。
コンストラクタと説明 |
---|
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からフォント・リソースをロードします。
|
String |
toString()
この
Font オブジェクトをString 表現に変換します。 |
public Font(double size)
size
- 使用するフォント・サイズpublic Font(String name, double size)
name
- 完全なフォント名。size
- 使用するフォント・サイズpublic static Font getDefault()
public static List<String> getFamilies()
public static List<String> getFontNames()
public static List<String> getFontNames(String family)
public static Font font(String family, FontWeight weight, FontPosture posture, double size)
ファミリの値をnullまたは空にした場合は、実装によってなんらかの適切なフォントが選択されます。
family
- フォントのファミリweight
- フォントの太さposture
- ポスチャまたはフォントのポスチャsize
- フォントのポイント・サイズ小数値にはできますが、負にはできません。サイズが0未満である場合は、デフォルト・サイズが使用されます。public static Font font(String family, FontWeight weight, double size)
family
- フォントのファミリweight
- フォントの太さsize
- フォントのポイント・サイズ小数値にはできますが、負にはできません。サイズが0未満である場合は、デフォルト・サイズが使用されます。public static Font font(String family, FontPosture posture, double size)
family
- フォントのファミリposture
- ポスチャまたはフォントのポスチャsize
- フォントのポイント・サイズ小数値にはできますが、負にはできません。サイズが0未満である場合は、デフォルト・サイズが使用されます。public static Font font(String family, double size)
family
- フォントのファミリsize
- フォントのポイント・サイズ小数値にはできますが、負にはできません。サイズが0未満である場合は、デフォルト・サイズが使用されます。public static Font font(String family)
family
- フォントのファミリpublic static Font font(double size)
size
- フォントのポイント・サイズ小数値にはできますが、負にはできません。サイズが0未満である場合は、デフォルト・サイズが使用されます。public final String getName()
1つの統合された方法を使用して、アプリケーションによって指定されているフォント(Font.loadFont()
を使用)、JavaFXランタイムに付属のフォントおよびシステムにインストールされているフォントをすべてロードできます。ロード対象のフォントの完全な名前を指定すると、単にフォントが作成されます。特定のフォントが見つからない場合は、フォールバックまたはデフォルト・フォントが使用されます。名前は、使用されるフォントの実際の名前を反映するように更新されます。フォントの名前とロード試行した名前を照合することによって、ロード失敗条件を調べることができます。
フォントをフォント・ファミリおよびスタイルで検索する場合は、このクラスに定義されているfont(java.lang.String, javafx.scene.text.FontWeight, javafx.scene.text.FontPosture, double)
ファクトリ・メソッドのいずれかを使用できます。
public final String getFamily()
public final String getStyle()
public final double getSize()
11.5
などの小数値になることもあります。指定された値が0未満である場合は、デフォルト・サイズが使用されます。public static Font loadFont(String urlStr, double size)
Font
オブジェクトが返されます。
アプリケーションに適切な権限がない場合は、指定されたフォント・サイズを持つデフォルト・システム・フォントが返されます。
URLの形式が誤っているために、移動やリソースからの読取りができない場合、またはフォントが表現されない場合など、失敗すると、null
が返されます。使用する前に、アプリケーションでこのことをチェックする必要があります。
成功してnull以外が返された場合は、使用可能なコンストラクタおよびファクトリ・メソッドによって作成できるように、FXグラフィックス・システムにフォントが登録されます。フォントのダウンロードとインストールのオーバーヘッドが繰り返されないように、アプリケーションでは、このメソッドを再度呼び出すのではなく、この方法でフォントを使用する必要があります。
フォントのsize
パラメータを使用すると、一般的な使用方法において、返された(null以外の)フォントをアプリケーションで直接使用でき、コンストラクタ経由で作成する必要がないため便利です。0以下のサイズは無効となり、かわりにデフォルト・サイズが使用されます。
URLがローカル・ディスク・ファイルを表す場合、コピーは実行されないため、アプリケーションの存続期間中、フォント・ファイルを維持する必要があります。なんらかの方法でファイルを更新すると、指定されていない、望ましくない動作が発生する場合があります。
urlStr
- フォントのロード元を表す文字列。size
- 返されたフォントのサイズ。public static Font loadFont(InputStream in, double size)
Font
オブジェクトが返されます。
アプリケーションに適切な権限がない場合は、指定されたフォント・サイズを持つデフォルト・システム・フォントが返されます。
省略形の入力が使用されるか、フォント書式がサポートされていないことなどが原因でロードに失敗すると、null
が返されます。使用する前に、アプリケーションでこのことをチェックする必要があります。
成功してnull以外が返された場合は、使用可能なコンストラクタおよびファクトリ・メソッドによって作成できるように、FXグラフィックス・システムにフォントが登録されます。フォントの再読取りとインストールのオーバーヘッドが繰り返されないように、アプリケーションでは、このメソッドを再度呼び出すのではなく、この方法でフォントを使用する必要があります。
フォントのsize
パラメータを使用すると、一般的な使用方法において、返された(null以外の)フォントをアプリケーションで直接使用でき、コンストラクタ経由で作成する必要がないため便利です。0以下のサイズは無効となり、かわりにデフォルト・サイズが使用されます。
このメソッドでは入力ストリームは閉じられません。
in
- フォントのロード元ストリーム。size
- 返されたフォントのサイズ。public String toString()
Font
オブジェクトをString
表現に変換します。文字列表現は情報提供のみを目的としており、変化します。この文字列表現をプログラミング用途で使用することは避けてください。public boolean equals(Object obj)
Copyright (c) 2008, 2015, Oracle and/or its affiliates. All rights reserved.