InsertAndReplaceContentControls

  • Post category:executeMethod
  • Запись изменена:07.11.2022
Print Friendly, PDF & EmailРаспечатать/сохранить в PDF

window.Asc.plugin.executeMethod(«InsertAndReplaceContentControls», [args], callback)

Описание
Определяет метод, позволяющий вставить элемент управления содержимым, содержащий данные. Данные задаются js-кодом для Document Builder или ссылкой на общий документ.

Использование
Этот метод следует использовать следующим образом:

window.Asc.plugin.executeMethod("InsertAndReplaceContentControls", [arrDocuments]);
Параметры
ПараметрОписаниеТипПример
arrDocumentsМассив свойств и содержимого элемента управления содержимым. Каждый объект из этого массива может иметь следующие значения:

  • Props -свойства управления содержимым,
    тип: объект;
  • Script — скрипт, который будет выполняться для генерации данных в элементе управления содержимым (можно заменить параметром Url),
    тип: строковый,
    пример: «{script}»;
  • Url — ссылка на общий файл (может быть заменена параметром Script),
    тип: строковый,
    пример: «https://example.com/script.docbuilder».
массив объектов

Объект Props может иметь следующие значения:

Параметры
ПараметрОписаниеТипПример
IdУникальный идентификатор элемента управления содержимым. Он может быть использован для поиска определенного элемента управления содержимым и ссылаться на него в коде.целочисленный2
TagТег, назначенный элементу управления содержимым. Один и тот же тег может быть присвоен нескольким элементам управления содержимым, чтобы на них можно было ссылаться в коде.строковый«{tag}»
LockЗначение, определяющее, можно ли удалять и/или редактировать элемент управления содержимым или нет.целочисленный0
InternalIdУникальный внутренний идентификатор элемента управления содержимым.строковый«1_713»
AliasАтрибут псевдонима.строковый«№1»
PlaceHolderTextТекст плейсхолдера элемента управления содержимым.строковый«placeholder text»
AppearanceОпределяет, отображается ли элемент управления содержимым в виде ограничивающей рамки (1) или нет (2).целочисленный1
ColorЦвет текущего элемента управления содержимым в формате RGB:

  • R — значение компонента красного цвета,
    тип: целочисленный,
    пример: 0;
  • G — значение компонента зеленого цвета,
    тип: целочисленный,
    пример: 0;
  • B — значение компонента синего цвета,
    тип: целочисленный,
    пример: 255;
объект

Параметр Lock может принимать следующие значения:

Численное значениеРедактированиеУдалить
0нетда
1нетнет
2данет
3дада

Возвращает
Метод возвращает данные, которые содержит созданный элемент управления содержимым (в формате JSON):

[
    {
        "Tag": "Document",
        "Id": 0,
        "Lock": 0,
        "InternalId": "1_713"
    }
]
Пример изменения существующего элемента управления содержимым
var arrDocuments = [{
    "Props": {
        "InternalId": "2_803"
    },
    "Script": "var oParagraph = Api.CreateParagraph();oParagraph.AddText('New text');Api.GetDocument().InsertContent([oParagraph]);"
}]
window.Asc.plugin.executeMethod("InsertAndReplaceContentControls", [arrDocuments]);
Пример добавления нового элемента управления содержимым
var arrDocuments = [{
    "Props": {
        "Id": 100,
        "Tag": "CC_Tag",
        "Lock": 3
    },
    "Script": "var oParagraph = Api.CreateParagraph();oParagraph.AddText('Hello world!');Api.GetDocument().InsertContent([oParagraph]);"
}]
window.Asc.plugin.executeMethod("InsertAndReplaceContentControls", [arrDocuments]);