Office.ContextMenu interface

Paket:

office

Stellt Optionen zum Verwalten des Status des Office-Kontextmenüs bereit.

Weitere Informationen finden Sie unter Ändern der Verfügbarkeit von Add-In-Befehlen.

Hinweise

Anforderungssatz: ContextMenuAPI 1.1

Methoden

requestUpdate(input)

Sendet eine Anforderung an Office, um das Kontextmenü zu aktualisieren.

Details zur Methode

requestUpdate(input)

Sendet eine Anforderung an Office, um das Kontextmenü zu aktualisieren.

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

Parameter

input

Office.ContextMenuUpdaterData

Stellt die Aktualisierungen dar, die an den Kontextmenüsteuerelementen vorgenommen werden sollen. Es werden nur die im control Parameter angegebenen Änderungen vorgenommen. Andere Kontextmenüsteuerelemente, die nicht angegeben sind, bleiben in der Office-Anwendung unverändert.

Gibt zurück

Promise<void>

Hinweise

Anforderungssatz: ContextMenuAPI 1.1

Wichtig: Diese API wird nur verwendet, um ein Update anzufordern. Die tatsächliche Aktualisierung der Benutzeroberfläche für das Kontextmenü wird von der Office-Anwendung gesteuert, sodass der genaue Zeitpunkt der Aktualisierung des Kontextmenüs (oder der Aktualisierung) nicht durch den Abschluss dieser API bestimmt werden kann.

Beispiele

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