Office.ContextMenu interface

Paquete:

office

Proporciona opciones para administrar el estado del menú contextual de Office.

Para más información, consulte Cambio de la disponibilidad de los comandos de complemento.

Comentarios

Conjunto de requisitos: ContextMenuAPI 1.1

Métodos

requestUpdate(input)

Envía una solicitud a Office para actualizar el menú contextual.

Detalles del método

requestUpdate(input)

Envía una solicitud a Office para actualizar el menú contextual.

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

Parámetros

input

Office.ContextMenuUpdaterData

Representa las actualizaciones que se realizarán en los controles del menú contextual. Solo se realizan los cambios especificados en el control parámetro . Otros controles de menú contextual que no se especifican permanecen tal cual en la aplicación de Office.

Devoluciones

Promise<void>

Comentarios

Conjunto de requisitos: ContextMenuAPI 1.1

Importante: Esta API solo se usa para solicitar una actualización. La aplicación de Office controla la actualización real de la interfaz de usuario en el menú contextual, por lo que el tiempo exacto de la actualización del menú contextual (o actualización) no se puede determinar mediante la finalización de esta API.

Ejemplos

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