Работа с параметрами

После импорта шаблона категории в Renga, все параметры, описанные в JSON, будут являться объектами таблицы Style и храниться в группе, к которой они принадлежат.

Примечание

Имена групп параметров и параметров берутся из JSON

Доступ к группе параметров

Получить группу параметров по имени

GetParameterGroup(groupName)

Parameters:

groupName (String) – Задает идентификатор (имя) группы параметров.

Returns:

Группа параметров

Return type:

ParameterGroup

Методы группы параметров

Вернуть значение параметра

:GetParameter(parameterName)

Parameters:

parameterName (String) – Задает идентификатор (имя) параметра.

Returns:

Параметр

Return type:

Parameter

Доступ к параметрам

Получить доступ к нужному параметру в скриптовой части можно следующими способами:

Получить таблицу значений параметров

GetParameterValues()

Returns:

Таблица значений параметров вида [имя группы][имя параметра][значение параметра].

Return type:

table of Parameters

Пример 1. Присвоение локальной переменной width значения параметра bodyWidth из группы параметров Dimensions

local parameters = Style.GetParameterValues()   -- получение таблицы значений параметров

local width = parameters["Dimensions"].bodyWidth

Эта запись эквивалентна:

Пример 2.

local width = parameters.Dimensions.bodyWidth

Получить параметр по имени группы и параметра

GetParameter(groupName, parameterName)

Parameters:

• groupName (String) – Задает идентификатор (имя) группы параметров.

• parameterName (String) – Задает идентификатор (имя) параметра.

Returns:

Параметр

Return type:

Parameter

Примечание

Имена групп параметров и параметров берутся из JSON

Пример 3. Присвоение локальной переменной width значения параметра bodyWidth из группы параметров Dimensions с использованием функций GetParameter() и GetValue()

local width = Style.GetParameter("Dimension", "bodyWidth"):GetValue()

Методы параметров

Вернуть значение параметра

:GetValue()

Returns:

Значение параметра.

Общие методы групп параметров и параметров

Включить или отключить отображение в редакторе стилей объекта

:SetVisible(isVisible)

Parameters:

isVisible – Булевое значение (true/false)

Return type:

Boolean

Пример 3. Скрытие группы параметров Dimension из диалога стилей объекта.

Style.GetParameterGroup("Dimension"):SetVisible(false)

Установить возможность редактирования в редакторе стилей объекта

:SetEnabled(isEnabled)

Parameters:

isEnabled – Булевое значение (true/false)

Return type:

Boolean