doc/docs/ru/manuals/gui-text.md

---

title: GUI-нода Text

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

GUI-нода Text

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Чтобы изменить шрифт ноды Text, используйте функцию gui.set_font().
• Чтобы изменить поведение переноса строки ноды Text, используйте функцию gui.set_line_break().

• Чтобы изменить содержимое ноды Text, используйте функцию 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