Skip to content

components.Label

Megabyte edited this page Dec 1, 2019 · 13 revisions

Наследуется от Text, и включает в себя все его свойства.

Label (Метка) - компонент, позволяющий отобразить значение некоторой javascript переменной в виде текста на экране.

Редактируемые свойства:

dataPath

Тип: data-path

Данное поле указывает путь к переменной javascript (либо путь к свойству объекта на экране), которая будет выступать в качестве значения отображаемого в виде текста. Подробнее о путях к переменным: Data-Path редактор Если значение переменной, путь к которой указан, окажется undefined, то метка автоматически станет невидимой.


refreshInterval

Тип: Number

Данное поле указывает c какой частотой производить обновление значения метки. Интервал обновления задается в кадрах (60 кадров равно 1 секунде). Для меток, значение которых никогда не меняется после инициализации сцены, можно установить очень большой интервал в целях оптимизации производительности.


template

Тип: String

Метка может иметь текстовый шаблон отображения, в котором комбинация '%d' будет соответствовать месту вставки значения отображаемой переменной. В случае, если у метке задан текстовый ресурс локализации (поле translatableText), поле template будет игнорироваться, а '%d' комбинация должна быть указана внутри локализованного текста. Подробнее: Редактор текстовых ресурсов


isNumeric

Тип: Boolean

Включает форматирование метки в виде числа с группировкой трех разрядов пробелом.


plusMinus

Тип: Boolean

Включает отображение знака '+' для положительных чисел.


counterSpeed

Тип: Number

Управляет шагом промотки значения метки при изменении значения переменной к которой она привязана. В играх очень часто значения счетчиков изменяются с эффектом промотки, данное поле указывает как быстро эта промотка будет происходить. 1 - моментально, 0.1 - на одну десятую от интервала между новым значением переменной и текущим отображаемым меткой значением. Частота обновления метки при перемотке определяется значением поля refreshInterval.


decimalsCount

Тип: Number

Задает количество десятичных нулей, до которых округлится значение при отображении на экран.


onChanged

Тип: call

Поле, позволяющее привязать действие, которое будет вызываться при изменении значения метки. Подробнее см. Callback редактор


Методы:

refreshNow ()

Метка имеет настраиваемый интервал обновления. Вызов данного метода сбрасывает текущий интервал, и значение метки обновится в следующем игровом кадре.


customizeVal (val)

возвращаемое значение: String

Этот метод полезен при создании собственных компонентов, наследующихся от Label. Переопределение этого метода позволяет добавить свою обработку для значения перед его выводом на кран.


Label.formatMoney (val : Number, decimalDigitsCount : Number = 0)

возвращаемое значение: String

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

<- Предыдущая страница Следующая страница ->

Связанные темы:

редактор тестовых ресурсов

Data-Path редактор

Свойства, унаследованные от Text

Компоненты

Редактируемые поля

Clone this wiki locally