Manuals
Manuals




This translation is community contributed and may not be up to date. We only maintain the English version of the documentation. Read this manual in English

GUI テキストノード

Defold は、GUI シーン(GUI scene)にテキストを描画できる専用の GUI ノード(GUI node)をサポートしています。プロジェクトに追加した任意のフォントリソースを、テキストノード(text node)の描画に使用できます。

テキストノードの追加

GUI テキストノードで使用するフォントは、GUI コンポーネント(GUI component)に追加する必要があります。Fonts フォルダーを右クリックするか、上部の GUI メニューを使用するか、対応するキーボードショートカットを押します。

フォント

テキストノードには、次の専用プロパティがあります。

Font
作成するすべてのテキストノードには、Font プロパティを設定する必要があります。
Text
このプロパティには、表示するテキストを指定します。
Line Break
テキストの揃え方はピボット(pivot)の設定に従います。このプロパティを設定すると、テキストを複数行にわたって表示できます。テキストの折り返し位置はノードの幅によって決まります。

テキストの揃え方

ノードのピボットを設定すると、テキストの揃え方を変更できます。

中央揃え
ピボットを CenterNorthSouth のいずれかに設定すると、テキストは中央揃えになります。
左揃え
ピボットを West のいずれかのモードに設定すると、テキストは左揃えになります。
右揃え
ピボットを East のいずれかのモードに設定すると、テキストは右揃えになります。

テキストの揃え方

実行時のテキストノードの変更

テキストノードには、サイズ、ピボット、色などを設定する汎用のノード操作関数をすべて使用できます。テキストノード専用の関数もいくつかあります。

  • テキストノードのフォントを変更するには、gui.set_font() 関数を使用します。
  • テキストノードの改行動作を変更するには、gui.set_line_break() 関数を使用します。
  • テキストノードの内容を変更するには、gui.set_text() 関数を使用します。
function on_message(self, message_id, message, sender)
    if message_id == hash("set_score") then
        local s = gui.get_node("score")
        gui.set_text(s, message.score)
    end
end