Office.Dialog interface

イベント ハンドラーを登録します。 サポートされているイベントは次の 2 つです。

• DialogMessageReceived. ダイアログ ボックスがメッセージを親に送信すると発生します。

• DialogEventReceived. ダイアログ ボックスが閉じられたとき、またはアンロードされたときに発生します。

addEventHandler(eventType: Office.EventType, handler: (args: {message: string, origin: string | undefined} | {error: number}) => void): void;

パラメーター

返品

例

// The following example shows how to open a dialog with a specified size. It also shows
// how to register a function to handle the message when Office.UI.messageParent() is called
// in the dialog and how to use that handler to close the dialog. The implementation of the processMessage() function is omitted.

Office.context.ui.displayDialogAsync("https://www.contoso.com/myDialog.html", { height: 30, width: 20 },
    (asyncResult) => {
        const dialog = asyncResult.value;
        dialog.addEventHandler(Office.EventType.DialogMessageReceived, (arg) => {
            dialog.close();
            processMessage(arg);
        });
    }
);

// The following example does the same thing in TypeScript.

Office.context.ui.displayDialogAsync("https://www.contoso.com/myDialog.html", { height: 30, width: 20 },
    (asyncResult: Office.AsyncResult) => {
        const dialog: Office.Dialog = asyncResult.value;
        dialog.addEventHandler(Office.EventType.DialogMessageReceived, (arg: string) => {
            dialog.close();
            processMessage(arg);
        });
    }
);

対応するダイアログ ボックスを閉じるために親ページから呼び出されます。

このメソッドは非同期です。 コールバック パラメーターを取らず、Promise オブジェクトを返さないので、await キーワード (keyword) 関数または then 関数を使用して待機させることはできません。 詳細については、次のベスト プラクティスを参照してください: ダイアログを閉じた直後に別のダイアログを開く

close(): void;

返品

例

// The following example shows how to open a dialog with a specified size. It also shows
// how to register a function to handle the message when Office.UI.messageParent() is called
// in the dialog and how to use that handler to close the dialog. The implementation of the processMessage() function is omitted.

Office.context.ui.displayDialogAsync("https://www.contoso.com/myDialog.html", { height: 30, width: 20 },
    (asyncResult) => {
        const dialog = asyncResult.value;
        dialog.addEventHandler(Office.EventType.DialogMessageReceived, (arg) => {
            dialog.close();
            processMessage(arg);
        });
    }
);

// The following example does the same thing in TypeScript.

Office.context.ui.displayDialogAsync("https://www.contoso.com/myDialog.html", { height: 30, width: 20 },
    (asyncResult: Office.AsyncResult) => {
        const dialog: Office.Dialog = asyncResult.value;
        dialog.addEventHandler(Office.EventType.DialogMessageReceived, (arg: string) => {
            dialog.close();
            processMessage(arg);
        });
    }
);

作業ウィンドウや UI を使用しない関数ファイルなどのホスト ページから、そのページから開かれたダイアログにメッセージを配信します。

messageChild(message: string, messageOptions?: DialogMessageOptions): void;

パラメーター

返品

注釈

アプリケーション: Excel、Outlook (最小要件セット: Mailbox 1.9)、PowerPoint、Word

要件セット:

• DialogApi 1.2

• Mailbox 1.9

• messageOptions パラメータを使用する場合は、DialogOrigin 1.1 も必要です。

従来の Outlook on Mac ではメールボックス 1.9 はサポートされませんが、DialogApi 1.2 はサポートされます。

例

// The following example shows how to send information about the current active worksheet to the dialog.
await Excel.run(async (context) => {
    const worksheet = context.workbook.worksheets.getActiveWorksheet();
    worksheet.load();
    await context.sync();
    worksheetPropertiesChanged(worksheet);
});

...

function worksheetPropertiesChanged(currentWorksheet) {
    const messageToDialog = JSON.stringify(currentWorksheet);
    dialog.messageChild(messageToDialog);
}

内部でのみ使用します。 コードを呼び込まないでください。

sendMessage(name: string): void;

パラメーター

返品