• Post category:executeMethod
  • Запись изменена:07.11.2022

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