Содержание
Описание. Меняет пункты плагина в уже открытом контекстном меню: текст, доступность и вложенное меню. Пункт находится по id. Если пункта с таким id в меню нет, он добавляется в конец. Так можно сначала показать недоступный пункт «Загрузка…», а когда данные придут — заменить его результатом. Подробнее в статье «Как плагин добавляет пункты в контекстное меню» ↗.
Если меню уже закрыто, вызов ничего не меняет, и при следующем открытии пункты снова берутся из ответа на onContextMenuShow.
Редакторы: документы, таблицы, презентации.
Параметры
Те же, что у AddContextMenuItem: объект { guid, items }. В items передаются только пункты, которые нужно изменить или добавить; остальные пункты остаются как были.
Возвращаемое значение
Метод ничего не возвращает: в функцию обратного вызова приходит undefined.
Пример
Показать недоступный пункт на время запроса, а потом подставить результат:
var lastRate = null;
window.Asc.plugin.attachEvent("onContextMenuShow", function (options) {
window.Asc.plugin.executeMethod("AddContextMenuItem", [{
guid: window.Asc.plugin.guid,
items: [{ id: "rate", text: "Курс: загрузка...", disabled: true }]
}]);
getRate().then(function (rate) { // getRate — функция плагина, которая получает курс
lastRate = rate;
window.Asc.plugin.executeMethod("UpdateContextMenuItem", [{
guid: window.Asc.plugin.guid,
items: [{ id: "rate", text: "Вставить курс: " + rate, disabled: false }]
}]);
});
});
window.Asc.plugin.attachContextMenuClickEvent("rate", function () {
window.Asc.plugin.executeMethod("PasteText", [String(lastRate)]);
});Не передавайте data в UpdateContextMenuItem: редактор ищет пункт по id вместе с data, поэтому существующий пункт не найдется и в меню появится второй. Храните нужное значение в переменной плагина, как в примере.













