Описание. Вставляет поле надстройки в позицию курсора. Если в документе выделен текст, поле заменяет его.
Редакторы: документы.
Параметры
| Параметр | Тип | Описание |
|---|---|---|
| data | объект | Данные поля: Value — служебная строка (обязательно), Content — видимый текст (необязательно) |
- Без Value поле не вставляется.
- Без Content в поле вставляются четыре пробела.
- FieldId передавать не нужно: редактор его игнорирует и назначает свой.
Возвращаемое значение
Метод ничего не возвращает: в функцию обратного вызова приходит undefined. Чтобы узнать FieldId нового поля, вызовите GetAllAddinFields.
Пример
Вставить поле с ценой товара и артикулом в служебной строке:
window.Asc.plugin.executeMethod("AddAddinField", [{
Value: "price;sku=42",
Content: "Цена: 100 руб."
}]);Что такое поле надстройки
Поле надстройки — это поле документа типа ADDIN. В нем плагин хранит свои данные прямо в документе: пользователь видит только текст поля, а служебная строка скрыта в коде поля. Так, например, менеджеры библиографии хранят данные ссылок.
Все четыре метода работают с объектом поля из трех свойств:
| Свойство | Тип | Описание |
|---|---|---|
| FieldId | строка | Идентификатор поля в документе, например «1». Редактор назначает его сам и заново при каждом открытии файла |
| Value | строка | Данные плагина, которые хранятся в коде поля. Пользователь их не видит |
| Content | строка | Текст поля, который виден в документе |
Поля с их Value и Content сохраняются в файле, а FieldId — нет: после повторного открытия у того же поля может быть другой FieldId. Поэтому не запоминайте FieldId между сеансами: записывайте свой идентификатор в Value, а актуальный FieldId берите из GetAllAddinFields перед каждым изменением.
Методы есть только в Документах. Изменения полей отменяются сочетанием Ctrl+Z за один шаг.













