Text

Textは、文字列を画面に表示するためのノードです。フォント、色、配置、ボーダーなど、豊富なテキスト表示オプションを提供し、ゲームやアプリケーションでのテキスト表示に必要な機能を備えています。

作成

public class GameScene : Scene
{
    public override void OnStart()
    {
        // シンプルなテキスト（デフォルトフォント、白色）
        var text = new Text("Hello, World!");
        Root.Add(text);

        // フォントとカラーを指定
        var styledText = new Text("Styled Text", Font.GetDefault(24), Color.Red)
            .Location(10, 50);
        Root.Add(styledText);
    }
}

テキストのプロパティ

基本プロパティ

テキスト内容

var text = new Text("初期テキスト");

// テキストを変更
text.Content = "新しいテキスト";

// 動的なテキスト更新
text.Content = $"スコア: {score}";

フォント

// デフォルトフォント
var defaultText = new Text("Default Font", Font.GetDefault());

// サイズ指定
var largeText = new Text("Large Text", Font.GetDefault(32));

// カスタムフォント
var customText = new Text("Custom Font", Font.FromFile("assets/MyFont.ttf", 24));

色

// 基本色
text.Color = Color.Red;
text.Color = Color.Blue;
text.Color = Color.Green;

// カスタムカラー
text.Color = Color.FromArgb(255, 200, 100, 50);

// 半透明
text.Color = Color.FromArgb(128, 255, 255, 255);

ボーダー

テキストに（縁取り）を追加できます。

var outlinedText = new Text("Outlined Text")
    .BorderColor(Color.Black)
    .BorderThickness(2);

// 太いボーダー
var thickBorderText = new Text("Thick Border")
    .Color(Color.White)
    .BorderColor(Color.DarkBlue)
    .BorderThickness(4);

配置とレイアウト

水平配置

// 左揃え（デフォルト）
text.HorizontalAlignment = HorizontalAlignment.Left;

// 中央揃え
text.HorizontalAlignment = HorizontalAlignment.Center;

// 右揃え
text.HorizontalAlignment = HorizontalAlignment.Right;

垂直配置

// 上揃え（デフォルト）
text.VerticalAlignment = VerticalAlignment.Top;

// 中央揃え
text.VerticalAlignment = VerticalAlignment.Center;

// 下揃え
text.VerticalAlignment = VerticalAlignment.Bottom;

サイズとワードラップ

var longText = new Text("これは非常に長いテキストで、指定された幅で自動的に折り返されます。")
    .PreferredSize(200, 100)  // 200x100の領域に表示
    .WordWrap(true);          // 自動折り返しを有効化

Root.Add(longText);

行間隔

var multilineText = new Text("Line 1\nLine 2\nLine 3")
    .LineSpacing(1.5f);  // 1.5倍の行間隔

リッチテキスト

部分的に文字装飾が可能です。リッチテキスト機能を参照してください。

var richText = new Text("", Font.GetDefault(16))
    .UseRichText(true);

// PTMLタグを使用
richText.Content = """
    <color=red>赤い文字</color> と <color=blue>青い文字</color>
    <size=24>大きな文字</size> と <size=12>小さな文字</size>
    <b>太字</b> と <i>斜体</i>
    """;