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

После импорта шаблона категории в 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