Office.ContextMenu interface

Paket:

office

Bietet Optionen zum Verwalten des Status des Office-Kontextmenüs.

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 zum Anfordern eines Updates verwendet. Das tatsächliche UI-Update des Kontextmenüs wird von der Office-Anwendung gesteuert, daher kann der genaue Zeitpunkt des Kontextmenü-Updates (oder -Updates) nicht durch den Abschluss dieser API bestimmt werden.

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