window.Asc.plugin.executeMethod («AddContentControlList», [args], callback)
Описание
Определяет метод, позволяющий добавить в документ пустой список управления содержимым.
Применение
Этот метод следует использовать следующим образом:
window.Asc.plugin.executeMethod ("AddContentControlList", [type, List, commonPr]);
Параметр | Описание | Тип | Пример |
type | Числовое значение, указывающее тип элемента управления содержимым. Может принимать одно из следующих значений: 1 (comboBox) или 0 (раскрывающийся список). | численный | 0 |
List | Список элементов управления содержимым, состоящий из двух элементов:- Display -элемент, который будет отображаться пользователю в списке управления содержимым,
тип: строковый, пример: «Item1_D»; - Value -значение каждого элемента из списка управления содержимым,
тип: строковый, пример: «Item1_V».
| массив объектов | |
commonPr | Определяет общие свойства элемента управления содержимым:- Id — уникальный идентификатор элемента управления содержимым. Его можно использовать для поиска определенного элемента управления содержимым и ссылки на него в коде.
тип: целое число, пример: 2; - Tag — тег, назначенный элементу управления содержимым. Один и тот же тег можно назначить нескольким элементам управления содержимым, чтобы можно было ссылаться на них в коде.
тип: строковый, пример: «{tag}»; - Lock -значение, которое определяет, возможно ли удалить и/или отредактировать содержимоеcontrol or not,
тип: целое число, пример: 0; - InternalId — уникальный внутренний идентификатор элемента управления контентом,
тип: строковый, пример: «1_713»; - Alias -атрибут псевдонима,
тип: строковый, пример: «№1»; - PlaceHolderText -текст заполнителя элемента управления содержимым,
тип: строковый, пример: «placeholder text»; - Appearance -определяет, отображается ли элемент управления содержимым в виде ограничивающей рамки (1) или нет (2),
тип: целое число, пример: 1; - Color — цвет для текущего элемента управления содержимым в формате RGB (R — значение составляющей красного цвета, G — значение составляющей зеленого цвета, B — значение составляющей синего цвета). Например: {«R»: 0, «G»: 0, «B»: 255},
тип: объект.
| объект | |
Параметр Lock может принимать следующие значения:
Числовое значение | Редактировать | Удалить |
0 | нет | да |
1 | нет | нет |
2 | да | нет |
3 | да | да |
window.Asc.plugin.executeMethod ("AddContentControlList", [0, [{Display: "Item1_D", Value: "Item1_V"}, {Display: "Item2_D", Value: "Item2_V"}], {"Id" : 7, "Tag" : "{tag}", "Lock" : 0}]);