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