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
        },
    ]
});