Office.ContextMenu interface

Paquet:

office

Fournit des options pour gérer l’état du menu contextuel Office.

Pour plus d’informations, consultez Modifier la disponibilité des commandes de complément.

Remarques

Ensemble de conditions requises : ContextMenuAPI 1.1

Méthodes

requestUpdate(input)

Envoie une demande à Office pour mettre à jour le menu contextuel.

Détails de la méthode

requestUpdate(input)

Envoie une demande à Office pour mettre à jour le menu contextuel.

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

Paramètres

input

Office.ContextMenuUpdaterData

Représente les mises à jour à apporter aux contrôles de menu contextuel. Seules les modifications spécifiées dans le control paramètre sont effectuées. Les autres contrôles de menu contextuel qui ne sont pas spécifiés restent tels quels dans l’application Office.

Retours

Promise<void>

Remarques

Ensemble de conditions requises : ContextMenuAPI 1.1

Important : cette API est utilisée uniquement pour demander une mise à jour. La mise à jour réelle de l’interface utilisateur vers le menu contextuel est contrôlée par l’application Office, de sorte que le moment exact de la mise à jour (ou de l’actualisation) du menu contextuel ne peut pas être déterminé par l’achèvement de cette API.

Exemples

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