---
title: GUI-нода Text
brief: В этом руководстве описано, как добавлять текст в GUI-сцены.
---

# GUI-нода Text

Defold поддерживает особый тип GUI-ноды, позволяющий отображать текст в GUI-сцене. Любой ресурс Font, добавленный в проект, может быть использован для рендеринга ноды Text.

## Добавление ноды Text

Шрифты, которые планируется использовать в GUI-нодах Text, должны быть добавлены в компонент GUI. Кликните ПКМ на папке *Fonts*, используйте контекстное меню <kbd>GUI</kbd> или нажмите соответствующее клавиатурное сокращение.

![Fonts](images/gui-text/fonts.png)

Нода Text обладает набором специфических свойств:

*Font*
: Любая созданная нода Text должна иметь настроенное свойство *Font*.

*Text*
: Отображаемый текст.

*Line Break*
: Выравнивание текста следует за настройкой пивота, и настройка этого свойства позволяет тексту располагаться на нескольких строках. Ширина ноды определяет, в каком месте текст будет перенесен.

## Выравнивание

Настроив пивот ноды, можно изменить режим выравнивания текста.

*Center*
: Если пивот установлен в `Center`, `North` или `South`, текст выравнивается по центру.

*Left*
: Если пивот установлен в какой-либо из режимов `West`, текст выравнивается по левому краю.

*Right*
: Если пивот установлен в один из режимов `East`, текст выравнивается по правому краю.

![Text alignment](images/gui-text/align.png)

## Воздействие на ноду Text в рантайме

Нода Text реагирует на любые общие функции манипуляции нодами по настройке размера, пивота, цвета и так далее. Существует несколько функций, предназначенных только для ноды Text:

* Чтобы изменить шрифт ноды Text, используйте функцию [`gui.set_font()`](/ref/gui/#gui.set_font).
* Чтобы изменить поведение переноса строки ноды Text, используйте функцию [`gui.set_line_break()`](/ref/gui/#gui.set_line_break).
* Чтобы изменить содержимое ноды Text, используйте функцию [`gui.set_text()`](/ref/gui/#gui.set_text).

```lua
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
```