Продукты Р7
Корпоративный сервер 2024
Корпоративный сервер 2024
Сервер документов
Сервер документов
Редакторы документов
Редакторы документов
Корпоративный сервер 2019
Корпоративный сервер 2019
Графика
Графика
ВКС и мессенджер
ВКС и мессенджер
Мобильные редакторы
Мобильные редакторы
Почтовый сервер
Почтовый сервер
Органайзер
Органайзер
Сервер лицензирования
Сервер лицензирования
Файл-Экспресс
Файл-Экспресс
Аналитика
Аналитика
Дополнительно
Часто задаваемые вопросы
Разработчикам
Интеграции
Новые возможности

UpdateContextMenuItem

Обновлено: 18.11.26

Инструкция актуальна для версий продукта: 2026.3.1.3296 – 2026.3.1.3906

Описание. Меняет пункты плагина в уже открытом контекстном меню: текст, доступность и вложенное меню. Пункт находится по 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, поэтому существующий пункт не найдется и в меню появится второй. Храните нужное значение в переменной плагина, как в примере.

Была ли эта статья полезной?

Поделитесь пожалуйста своим мнением

      В статье есть ошибкиРекомендации не помоглиТекст трудно понятьСодержание статьи не соответствует заголовкуДругое