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}]);
