Office.ContextMenu interface

Pacote:

office

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

Para saber mais, veja Alterar a disponibilidade dos comandos de suplementos.

Comentários

Conjunto de requisitos: ContextMenuAPI 1.1

Métodos

requestUpdate(input)

Envia um pedido ao Office para atualizar o menu de contexto.

Detalhes do método

requestUpdate(input)

Envia um pedido 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 aos controlos de menu de contexto. Apenas as alterações especificadas no control parâmetro são efetuadas. Outros controlos de menu de contexto que não são especificados permanecem como estão na aplicação do Office.

Retornos

Promise<void>

Comentários

Conjunto de requisitos: ContextMenuAPI 1.1

Importante: esta API só é utilizada para pedir uma atualização. A atualização real da IU para o menu de contexto é controlada pela aplicação do Office, pelo que a temporização exata da atualização (ou atualização) do menu de contexto não pode ser determinada pela conclusão desta 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
        },
    ]
});