Поделиться через

Office.ContextMenu interface

Пакет:
office

Предоставляет параметры для управления состоянием контекстного меню Office.

Дополнительные сведения см. в статье Изменение доступности команд надстроек.

Комментарии

Набор обязательных требований: ContextMenuAPI 1.1

Методы

requestUpdate(input)

Отправляет запрос в Office на обновление контекстного меню.

Сведения о методе

requestUpdate(input)

Отправляет запрос в Office на обновление контекстного меню.

requestUpdate(input: ContextMenuUpdaterData): Promise<void>;

Параметры

input
Office.ContextMenuUpdaterData

Представляет обновления, которые будут внесены в элементы управления контекстного меню. Вносятся только изменения, указанные control в параметре . Другие элементы управления контекстного меню, которые не указаны, остаются в приложении Office.

Возвращаемое значение

Promise<void>

Комментарии

Набор обязательных требований: ContextMenuAPI 1.1

Важно! Этот API используется только для запроса обновления. Фактическое обновление пользовательского интерфейса в контекстном меню управляется приложением Office, поэтому точное время обновления контекстного меню (или обновления) не может быть определено завершением этого API.

Примеры

// Change the availability of custom buttons on the context menu.
await Office.contextMenu.requestUpdate({
    controls: [
        {
            id: Addin.CtxMenu.Button1,
            enabled: true
        },
        {
            id: Addin.CtxMenu.Button2,
            enabled: false
        },
    ]
});