Office.ContextMenu interface

Pacote:

office

Fornece opções para gerenciar o estado do menu de contexto do Office.

Para saber mais, consulte Alterar a disponibilidade de comandos do suplemento.

Comentários

Conjunto de requisitos: ContextMenuApi 1.1

Métodos

requestUpdate(input)

Envia uma solicitação ao Office para atualizar o menu de contexto.

Detalhes do método

requestUpdate(input)

Envia uma solicitação ao Office para atualizar o menu de contexto.

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

Parâmetros

input

Office.ContextMenuUpdaterData

Representa as atualizações a serem feitas nos controles do menu de contexto. Somente as alterações especificadas no control parâmetro são feitas. Outros controles de menu de contexto não especificados permanecem como estão no aplicativo do Office.

Retornos

Promise<void>

Comentários

Conjunto de requisitos: ContextMenuApi 1.1

Importante: essa API é usada apenas para solicitar uma atualização. A atualização real da interface do usuário para o menu de contexto é controlada pelo aplicativo do Office, portanto, o momento exato da atualização (ou atualização) do menu de contexto não pode ser determinado pela conclusão dessa API.

Exemplos

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