Office.ContextMenu interface

パッケージ:

office

Office コンテキスト メニューの状態を管理するためのオプションを提供します。

詳細については、「アドイン コマンドの可用性を変更する」を参照してください。

注釈

要件セット: ContextMenuApi 1.1

メソッド

requestUpdate(input)

コンテキスト メニューを更新する要求を Office に送信します。

メソッドの詳細

requestUpdate(input)

コンテキスト メニューを更新する要求を Office に送信します。

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

パラメーター

input

Office.ContextMenuUpdaterData

コンテキスト メニュー コントロールに対して行われる更新を表します。 control パラメーターで指定された変更のみが行われます。 指定されていないその他のコンテキスト メニュー コントロールは、Office アプリケーションにそのまま残ります。

返品

Promise<void>

注釈

要件セット: ContextMenuApi 1.1

重要: この API は、更新を要求するためにのみ使用されます。 コンテキスト メニューへの実際の UI の更新は Office アプリケーションによって制御されるため、コンテキスト メニューの更新 (または更新) の正確なタイミングは、この API の完了によっては判別できません。

例

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