JavaFXのtextOrigin（テキストオリジン）とは？VPosで原点を指定する方法を解説

JavaFXでは、ノードの配置に使用する通常のローカル座標系に加えて、テキストノード専用にもう一つの座標系が用意されています。

textOriginプロパティは、親座標系におけるテキストノードの座標原点を指定するためのものです。このプロパティに値を設定するには、setTextOrigin()メソッドを使用します。このメソッドは、VPosという列挙型の定数を引数として受け取ります。

VPos列挙型の4つの定数

VPos列挙型には、以下の4つの定数が定義されています。

• BASELINE：テキストのベースライン（文字の下端基準線）を原点として扱います。
• BOTTOM：テキスト全体の下端を原点として扱います。
• CENTER：テキスト全体の中央を原点として扱います。
• TOP：テキスト全体の上端を原点として扱います。

サンプルコード

import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.InputStream;
import java.util.Scanner;
import javafx.application.Application;
import javafx.geometry.VPos;
import javafx.scene.Group;
import javafx.scene.Scene;
import javafx.scene.paint.Color;
import javafx.stage.Stage;
import javafx.scene.text.Text;

public class TextOriginExample extends Application {
   public void start(Stage stage) throws FileNotFoundException {
      // テキストファイルの内容を読み込む
      InputStream inputStream = new FileInputStream("D:\\sample_text.txt");
      Scanner sc = new Scanner(inputStream);
      StringBuffer sb = new StringBuffer();
      while(sc.hasNext()) {
         sb.append(" "+sc.nextLine()+"\n");
      }
      // Textオブジェクトを作成
      Text text = new Text(10.0, 25.0, sb.toString());
      // テキストの折り返し幅を設定
      text.setWrappingWidth(565);
      // 垂直方向の位置指定（原点）を設定
      text.setTextOrigin(VPos.TOP);
      // ステージの設定
      Group root = new Group(text);
      Scene scene = new Scene(root, 595, 150, Color.BEIGE);
      stage.setTitle("Text Origin (TOP)");
      stage.setScene(scene);
      stage.show();
   }
   public static void main(String args[]){
      launch(args);
   }
}

sample.txtの内容

ここでは、sample_text.txtファイルの内容が以下の通りであると仮定します。

Tutorials Point originated from the idea that there exists a class of readers who respond better 
to online content and prefer to learn new skills at their own pace from the comforts of their drawing rooms.
The journey commenced with a single tutorial on HTML in 2006 and elated by the response it generated, 
we worked our way to adding fresh tutorials to our repository which now proudly flaunts a wealth of 
tutorials and allied articles on topics ranging from programming languages to web designing to academics 
and much more.

実行結果

上記のコードを実行すると、TOPを指定した場合、テキストブロックの上端が指定座標の原点となり、次のように表示されます。

同様に、setTextOrigin()に渡す値を変更すると、原点の位置が変わり、表示結果もそれに応じて変化します。

BASELINEを指定した場合 −

BOTTOMを指定した場合 −

CENTERを指定した場合 −

このように、textOriginプロパティを使い分けることで、テキストノードを親座標系のどの位置を基準に配置するかを柔軟に制御できます。特にベースラインを揃えたいレイアウトや、複数行テキストの垂直配置を調整したい場合に便利です。