Office アドインで Office ダイアログ API を使用する

[アーティクル]
11/30/2023

Office ダイアログ API を使用して、Office アドインでダイアログボックスを開きます。この記事では、Office アドインでダイアログ API を使用するためのガイダンスを提供します。作業ウィンドウ、コンテンツアドイン、またはアドインコマンドからダイアログボックスを開いて、次の操作を行うことを検討してください。

Google、Facebook、Microsoft ID などのリソースを使用してユーザーにサインインします。詳細については、「 Office ダイアログ API を使用した認証」を参照してください。
アドインでの作業用に画面領域を広げる (あるいは全画面表示)。
ビデオが作業ウィンドウに限定されている場合に、小さすぎるビデオをホストする。

注意

UI 要素を重ねて表示することはお勧めできないため、シナリオで必要な場合を除き、作業ウィンドウでダイアログボックスを開かないようにします。作業ウィンドウの表示領域の使用方法を検討するときには、作業ウィンドウはタブ表示できることに注意してください。タブ付き作業ウィンドウの例については、 Excel アドイン JavaScript SalesTracker サンプルを参照してください。

次の画像は、ダイアログボックスの例を示します。

WordでMicrosoft ID プラットフォームを使用したサインインダイアログ。

ダイアログボックスは常に画面の中央に開きます。ユーザーはダイアログボックスの移動とサイズ変更ができます。ウィンドウは 非変更です。ユーザーは、Office アプリケーション内のドキュメントと、作業ウィンドウ内のページ (存在する場合) の両方を引き続き操作できます。

ホストページからダイアログボックスを開く

Office JavaScript API には、Dialog オブジェクトと Office.context.ui 名前空間の 2 つの関数が含まれます。

ダイアログボックスを開くには、コード (通常は作業ウィンドウ内のページ) で displayDialogAsync メソッドを呼び出して、開くリソースの URL を渡します。このメソッドを呼び出すページは、「ホストページ」と呼ばれます。たとえば、作業ウィンドウの index.html にあるスクリプトでこのメソッドを呼び出した場合は、index.html がメソッドが開いたダイアログボックスのホストページです。

ダイアログボックスで開かれるリソースは通常ページですが、MVC アプリケーションのコントローラーメソッド、ルート、Web サービスメソッド、またはその他のリソースの場合もあります。この記事では、'ページ' または 'Web サイト' とは、ダイアログボックス内のリソースを意味します。次のコードは簡単な例です。

Office.context.ui.displayDialogAsync('https://www.contoso.com/myDialog.html');

URL には HTTPS プロトコルを使用します。これは、読み込まれる最初のページだけでなく、ダイアログボックスに読み込まれるすべてのページに対して必須です。
ダイアログボックスのドメインはホストページのドメインと同じです。ホストページは、作業ウィンドウ内のページまたはアドインコマンドの関数ファイルにすることができます。ページ、コントローラーメソッド、またはそのメソッドに渡されるその他の displayDialogAsync リソースは、ホストページと同じドメインに存在する必要があります。

Important

ダイアログボックスで開くホストページとリソースのフルドメインは、同じである必要があります。 displayDialogAsync にアドインのドメインのサブドメインを渡そうとすると、正常に動作しません。サブドメインを含む、フルドメインが一致している必要があります。

最初のページ (または他のリソース) が読み込まれると、ユーザーはリンクまたは他の UI を使用して HTTPS を使用する任意の Web サイト (または他のリソース) に移動できます。また、すぐに別のサイトにリダイレクトするように最初のページを設計することもできます。

既定では、ダイアログボックスのサイズはデバイス画面の高さと幅の 80% ですが、次の例に示すように、メソッドに構成オブジェクトを渡すことによってさまざまな割合を設定できます。

Office.context.ui.displayDialogAsync('https://www.contoso.com/myDialog.html', {height: 30, width: 20});

これを行うサンプルアドインについては、「 Excel 用 Office アドインのビルド」を参照してください。を使用 displayDialogAsyncするその他のサンプルについては、「コードサンプル」を参照してください。

実質的に全画面表示エクスペリエンスを得るには、両方の値を 100% に設定します。有効な最大値は 99.5% で、ウィンドウは引き続き移動可能でサイズ変更可能です。

ホストウィンドウから開くことができるのは、1 つのダイアログボックスのみです。別のダイアログボックスを開こうとすると、エラーが発生します。たとえば、ユーザーが作業ウィンドウからダイアログボックスを開いた場合、作業ウィンドウの別のページから 2 つ目のダイアログボックスを開くわけではありません。ただし、アドインコマンドからダイアログボックスを開く場合は、選択するたびにコマンドによって新しい (ただし非表示の) HTML ファイルが開かれます。これにより、新しい (非表示) ホストウィンドウが作成されるため、これらの各ウィンドウは独自のダイアログボックスを起動できます。詳細については、「displayDialogAsync のエラー」を参照してください。

Office on the web のパフォーマンスオプションを利用する

displayInIframe プロパティは、displayDialogAsync に渡すことのできる構成オブジェクトの追加のプロパティです。このプロパティを true に設定し、Office on the web で開いたドキュメントでアドインを実行している場合、ダイアログボックスは浮動の iframe で開き、独立したウィンドウでは開きません (この方が速く開きます)。次に例を示します。

Office.context.ui.displayDialogAsync('https://www.contoso.com/myDialog.html', {height: 30, width: 20, displayInIframe: true});

既定値は false です。これはプロパティを完全に省略した場合と同じ状態です。アドインがOffice on the webで実行されていない場合、 displayInIframe は無視されます。

注意

ダイアログボックスが iframe で開くことができないページにリダイレクトされる場合は、使用displayInIframe: trueしないでください。たとえば、Google や Microsoft アカウントなど、多くの一般的な Web サービスのサインインページを iframe で開くすることはできません。

ダイアログボックスからホストページに情報を送信する

ダイアログボックスのコードでは、 messageParent 関数を使用して、ホストページに文字列メッセージを送信します。文字列には、単語、文、XML BLOB、文字列化された JSON、または文字列にシリアル化したり、文字列にキャストしたりできるその他の何かを指定できます。メソッドを messageParent 使用するには、ダイアログボックスで最初に Office JavaScript API を初期化する必要があります。

注意

わかりやすくするために、このセクションではホスト ページをターゲットとするメッセージを呼び出しますが、厳密に言うと、メッセージは作業ウィンドウ (または関数ファイルをホストしているランタイム) のランタイムに移動します。この区別は、クロスドメインメッセージングの場合にのみ重要です。詳細については、「ホストランタイムへのクロスドメインメッセージング」をご覧ください。

次の例は、Office JS を初期化し、ホストページにメッセージを送信する方法を示しています。

Office.onReady(function() {
   // Add any initialization code for your dialog here.
});

// Called when dialog signs in the user.
function userSignedIn() {
    Office.context.ui.messageParent(true.toString());
}

次の例では、プロファイル情報を含む JSON 文字列を返す方法を示します。

function userProfileSignedIn(profile) {
    const profileMessage = {
        "name": profile.name,
        "email": profile.email,
    };
    Office.context.ui.messageParent(JSON.stringify(profileMessage));
}

この messageParent 関数は、ダイアログボックスで呼び出すことができる 2 つの Office JS API のうちの 1 つだけ です。ダイアログボックスで呼び出すことができるもう 1 つの JS API はです Office.context.requirements.isSetSupported。詳細については、「 Office アプリケーションと API の要件を指定する」を参照してください。ただし、ダイアログボックスでは、この API はボリュームライセンスの永続的なOutlook 2016 (つまり MSI バージョン) ではサポートされていません。

ホストページは、メッセージを受信するように構成する必要があります。これを構成するには、displayDialogAsync の元の呼び出しにコールバックパラメーターを追加します。コールバックはハンドラーを DialogMessageReceived イベントに割り当てます。次に例を示します。

let dialog; // Declare dialog as global for use in later functions.
Office.context.ui.displayDialogAsync('https://www.contoso.com/myDialog.html', {height: 30, width: 20},
    function (asyncResult) {
        dialog = asyncResult.value;
        dialog.addEventHandler(Office.EventType.DialogMessageReceived, processMessage);
    }
);

Office は AsyncResult オブジェクトをコールバックに渡します。 Office はダイアログボックスを開こうとした結果を表します。ただし、ダイアログボックスでのイベントの結果は表しません。この違いの詳細については、「エラーとイベントの処理」を参照してください。

asyncResult の value プロパティは Dialog オブジェクトに設置されます。このオブジェクトはダイアログボックスの実行コンテキストではなく、ホストページに存在します。
processMessage はイベントを処理する関数です。任意の名前を指定できます。
dialog 変数は、processMessage でも参照されるため、コールバックよりも広い範囲で宣言されます。

DialogMessageReceived イベントのハンドラーの簡単な例を次に示します。

function processMessage(arg) {
    const messageFromDialog = JSON.parse(arg.message);
    showUserName(messageFromDialog.name);
}

Office は arg オブジェクトをハンドラーに渡します。その message プロパティは、ダイアログボックスのの呼び出し messageParent によって送信される文字列です。この例では、Microsoft アカウントや Google などのサービスからのユーザーのプロファイルの文字列化された表現であるため、を使用 JSON.parseしてオブジェクトに逆シリアル化されます。実装は showUserName 表示されません。作業ウィンドウ上に個人用のウェルカムメッセージが表示される場合があります。

ダイアログボックスのユーザー操作が完了すると、次の例に示すようにメッセージハンドラーはダイアログボックスを閉じます。

function processMessage(arg) {
    dialog.close();
    // message processing code goes here;
}

dialog オブジェクトは displayDialogAsync の呼び出しによって返されるものと同じである必要があります。オブジェクトを dialog グローバル変数として宣言する必要があります。または、次の dialog 例に displayDialogAsync 示すように、匿名コールバック関数を使用して、オブジェクトのスコープを呼び出すことができます。この例では、 processMessage メソッドが匿名コールバック関数で呼び出されるため close 、ダイアログを閉じる必要はありません。

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

メッセージを受信した後、アドインで作業ウィンドウの別のページを開く必要がある場合は、ハンドラーの最後の行として window.location.replace メソッド (または window.location.href) を使用できます。次に例を示します。

function processMessage(arg) {
    // message processing code goes here;
    window.location.replace("/newPage.html");
    // Alternatively ...
    // window.location.href = "/newPage.html";
}

これを実行するアドインの例については、「Insert Excel charts using Microsoft Graph in a PowerPoint add-in」 (PowerPoint アドインで Microsoft Graph を使用した Excel グラフの挿入) のサンプルを参照してください。

条件付きのメッセージング

ダイアログボックスから複数の messageParent 呼び出しを送信できますが、DialogMessageReceived イベントのホストページにあるハンドラーは 1 つのみのため、ハンドラーは条件ロジックを使用してさまざまなメッセージを区別する必要があります。たとえば、ダイアログボックスで、Microsoft アカウントや Google などの ID プロバイダーへのサインインを求めるメッセージが表示された場合、ユーザーのプロファイルがメッセージとして送信されます。認証が失敗した場合、次の例のように、ダイアログボックスからホストページにエラー情報が送信されます。

if (loginSuccess) {
    const userProfile = getProfile();
    const messageObject = {messageType: "signinSuccess", profile: userProfile};
    const jsonMessage = JSON.stringify(messageObject);
    Office.context.ui.messageParent(jsonMessage);
} else {
    const errorDetails = getError();
    const messageObject = {messageType: "signinFailure", error: errorDetails};
    const jsonMessage = JSON.stringify(messageObject);
    Office.context.ui.messageParent(jsonMessage);
}

前の例については、次の点に注意してください。

loginSuccess 変数は、ID プロバイダーからの HTTP 応答を読み取ることによって初期化されます。
および getError 関数のgetProfile実装は表示されません。両方の関数はそれぞれ、クエリパラメーターまたは HTTP 応答の本文からデータを取得します。
サインインが成功したかどうかに応じて、さまざまな種類の匿名のオブジェクトが送信されます。両方の関数に messageType プロパティがありますが、一方には profile プロパティ、もう一方には error プロパティがあります。

ホストページのハンドラーコードでは、次の例に示すように、プロパティの値を messageType 使用して分岐します。関数は前の showUserName 例と同じであり、 showNotification 関数はホストページの UI にエラーを表示します。

function processMessage(arg) {
    const messageFromDialog = JSON.parse(arg.message);
    if (messageFromDialog.messageType === "signinSuccess") {
        dialog.close();
        showUserName(messageFromDialog.profile.name);
        window.location.replace("/newPage.html");
    } else {
        dialog.close();
        showNotification("Unable to authenticate user: " + messageFromDialog.error);
    }
}

実装は showNotification 表示されません。作業ウィンドウの通知バーに状態が表示される場合があります。

ホストランタイムへのクロスドメインメッセージング

ダイアログが開いた後、ダイアログまたは親ランタイムがアドインのドメインから離れる可能性があります。これらの処理のいずれかが発生した場合、コードで親ランタイムの messageParent ドメインが指定されていない限り、の呼び出しは失敗します。これを行うには、の呼び出しmessageParentに DialogMessageOptions パラメーターを追加します。このオブジェクトには、 targetOrigin メッセージを送信するドメインを指定するプロパティがあります。パラメーターが使用されていない場合、Office は、ターゲットがダイアログが現在ホストしているのと同じドメインであると想定します。

注意

を使用して messageParent クロスドメインメッセージを送信するには、 Dialog Origin 1.1 要件セットが必要です。パラメーターは DialogMessageOptions 、要件セットをサポートしていない古いバージョンの Office では無視されるため、渡してもメソッドの動作は影響を受けません。

を使用して messageParent クロスドメインメッセージを送信する例を次に示します。

Office.context.ui.messageParent("Some message", { targetOrigin: "https://resource.contoso.com" });

メッセージに機密データが含まれていない場合は、を "*" に設定 targetOrigin すると、任意のドメインに送信できます。次に例を示します。

Office.context.ui.messageParent("Some message", { targetOrigin: "*" });

ヒント

パラメーターは DialogMessageOptions 、2021 年半ばに必要なパラメーターとしてメソッドに追加 messageParent されました。メソッドでクロスドメインメッセージを送信する古いアドインは、新しいパラメーターを使用するように更新されるまで機能しなくなりました。アドインが更新されるまで、 Office on Windows でのみ、ユーザーとシステム管理者は、レジストリ設定で信頼されたドメインを指定することで、これらのアドインの作業を続行できます。 HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\WEF\AllowedDialogCommunicationDomains。これを行うには、拡張子を持つファイルを .reg 作成し、Windows コンピューターに保存し、ダブルクリックして実行します。このようなファイルの内容の例を次に示します。

Windows Registry Editor Version 5.00

[HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\WEF\AllowedDialogCommunicationDomains]
"My trusted domain"="https://www.contoso.com"
"Another trusted domain"="https://fabrikam.com"

情報をダイアログボックスに渡す

アドインは、Dialog.messageChild を使用して、ホストページからダイアログボックスにメッセージを送信できます。

ホストページからを使用 `messageChild()` する

Office ダイアログ API を呼び出してダイアログボックスを開くと、 Dialog オブジェクトが返されます。他の関数から参照できるように、グローバルスコープを持つ変数に割り当てる必要があります。次に例を示します。

let dialog; // Declare as global variable.
Office.context.ui.displayDialogAsync('https://www.contoso.com/myDialog.html',
    function (asyncResult) {
        dialog = asyncResult.value;
        dialog.addEventHandler(Office.EventType.DialogMessageReceived, processMessage);
    }
);

function processMessage(arg) {
    dialog.close();

  // message processing code goes here;

}

この Dialog オブジェクトには、文字列化されたデータを含む任意の文字列をダイアログボックスに送信する messageChild メソッドがあります。これにより、 DialogParentMessageReceived ダイアログボックスでイベントが発生します。次のセクションに示すように、コードでこのイベントを処理する必要があります。

ダイアログの UI が現在アクティブなワークシートに関連し、そのワークシートの位置が他のワークシートに関連するシナリオを考えてみましょう。次の例では、 sheetPropertiesChanged Excel ワークシートのプロパティをダイアログボックスに送信します。この場合、現在のワークシートの名前は "マイシート" で、ブック内の 2 番目のシートです。データはオブジェクトにカプセル化され、に渡すことができるように文字列化されます messageChild。

function sheetPropertiesChanged() {
    const messageToDialog = JSON.stringify({
                               name: "My Sheet",
                               position: 2
                           });

    dialog.messageChild(messageToDialog);
}

ダイアログボックスで DialogParentMessageReceived を処理する

ダイアログボックスの JavaScript で、UI.addHandlerAsync メソッドをDialogParentMessageReceived使用してイベントのハンドラーを登録します。これは通常、次に示すように、Office.onReady または Office.initialize 関数で行われます。 (より堅牢な例については、この記事の後半で説明します)。

Office.onReady(function () {
  Office.context.ui.addHandlerAsync(Office.EventType.DialogParentMessageReceived,
    onMessageFromParent);
});

次に、ハンドラーを onMessageFromParent 定義します。次のコードでは、前のセクションの例を続けます。 Office はハンドラーに引数を渡し、 message 引数オブジェクトのプロパティにホストページの文字列が含まれていることに注意してください。この例では、メッセージをオブジェクトに再変換し、jQuery を使用して、ダイアログの先頭見出しを新しいワークシート名と一致するように設定します。

function onMessageFromParent(arg) {
  const messageFromParent = JSON.parse(arg.message);
  document.querySelector('h1').textContent = messageFromParent.name;
}

ハンドラーが適切に登録されていることを確認することをお勧めします。これを行うには、メソッドにコールバックを addHandlerAsync 渡します。これは、ハンドラーの登録試行が完了したときに実行されます。ハンドラーが正常に登録されていない場合は、ハンドラーを使用してログを記録するか、エラーを表示します。次に例を示します。 reportErrorこれは、エラーをログに記録または表示する関数であり、ここで定義されていないことに注意してください。

Office.onReady(function () {
  Office.context.ui.addHandlerAsync(
    Office.EventType.DialogParentMessageReceived,
      onMessageFromParent,
      onRegisterMessageComplete);
});

function onRegisterMessageComplete(asyncResult) {
  if (asyncResult.status !== Office.AsyncResultStatus.Succeeded) {
    reportError(asyncResult.error.message);
  }
}

親ページからダイアログボックスへの条件付きメッセージング

ホストページから複数 messageChild の呼び出しを行うことができますが、イベントのダイアログボックス DialogParentMessageReceived にはハンドラーが 1 つだけであるため、ハンドラーは条件付きロジックを使用して異なるメッセージを区別する必要があります。これは、「条件付きメッセージング」で説明されているように、ダイアログボックスがホストページにメッセージを送信するときに条件付きメッセージングを構成する方法と正確に平行な方法で行うことができます。

注意

状況によっては、messageChildDialogApi 1.2 要件セットの一部である API がサポートされない場合があります。たとえば、messageChildボリュームライセンスの永続的なOutlook 2016とボリュームライセンスの永続的な Outlook 2019 ではサポートされていません。親からダイアログボックスへのメッセージングのいくつかの代替方法については、「ホストページからダイアログボックスにメッセージを渡す代替方法」で説明されています。

Important

DialogApi 1.2 要件セットは、アドインマニフェストの [要件>]< セクションで指定できません。「ランタイムによるメソッドと要件セットのサポートのチェック」の説明に従って、メソッドをisSetSupported使用して、実行時に DialogApi 1.2 のサポートをチェックする必要があります。マニフェスト要件のサポートは開発中です。

ダイアログランタイムへのクロスドメインメッセージング

ダイアログが開いた後、ダイアログまたは親ランタイムがアドインのドメインから離れる可能性があります。これらの処理のいずれかが発生した場合、コードでダイアログランタイムのドメインが指定されていない限り、の呼び出し messageChild は失敗します。これを行うには、の呼び出しmessageChildに DialogMessageOptions パラメーターを追加します。このオブジェクトには、 targetOrigin メッセージを送信するドメインを指定するプロパティがあります。パラメーターが使用されていない場合、Office は、ターゲットが親ランタイムが現在ホストしているドメインと同じドメインであると想定します。

注意

を使用して messageChild クロスドメインメッセージを送信するには、 Dialog Origin 1.1 要件セットが必要です。パラメーターは DialogMessageOptions 、要件セットをサポートしていない古いバージョンの Office では無視されるため、渡してもメソッドの動作は影響を受けません。

を使用して messageChild クロスドメインメッセージを送信する例を次に示します。

dialog.messageChild(messageToDialog, { targetOrigin: "https://resource.contoso.com" });

メッセージに機密データが含まれていない場合は、を "*" に設定 targetOrigin すると、任意のドメインに送信できます。次に例を示します。

dialog.messageChild(messageToDialog, { targetOrigin: "*" });

ダイアログをホストしているランタイムはマニフェストの AppDomains> セクションにアクセス<できないため、メッセージが送信されるドメインが信頼されているかどうかを判断するため、ハンドラーをDialogParentMessageReceived使用してこれを判断する必要があります。ハンドラーに渡されるオブジェクトには、親で現在ホストされているドメインが origin プロパティとして含まれています。プロパティの使用方法の例を次に示します。

function onMessageFromParent(arg) {
    if (arg.origin === "https://addin.fabrikam.com") {
        // process message
    } else {
        dialog.close();
        showNotification("Messages from " + arg.origin + " are not accepted.");
    }
}

たとえば、コードで Office.onReady または Office.initialize 関数を使用して、信頼されたドメインの配列をグローバル変数に格納できます。その後、ハンドラー内の arg.origin そのリストに対してプロパティをチェックできます。

ヒント

パラメーターは DialogMessageOptions 、2021 年半ばに必要なパラメーターとしてメソッドに追加 messageChild されました。メソッドでクロスドメインメッセージを送信する古いアドインは、新しいパラメーターを使用するように更新されるまで機能しなくなりました。アドインが更新されるまで、 Office on Windows でのみ、ユーザーとシステム管理者は、レジストリ設定で信頼されたドメインを指定することで、これらのアドインの作業を続行できます。 HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\WEF\AllowedDialogCommunicationDomains。これを行うには、拡張子を持つファイルを .reg 作成し、Windows コンピューターに保存し、ダブルクリックして実行します。このようなファイルの内容の例を次に示します。

Windows Registry Editor Version 5.00

[HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\WEF\AllowedDialogCommunicationDomains]
"My trusted domain"="https://www.contoso.com"
"Another trusted domain"="https://fabrikam.com"

ダイアログボックスを閉じる

ダイアログボックスを閉じるボタンをダイアログボックス内に実装できます。これを実行するには、ボタンのクリックイベントハンドラーは messageParent を使用して、ボタンがクリックされたことをホストページに通知する必要があります。次に例を示します。

function closeButtonClick() {
    const messageObject = {messageType: "dialogClosed"};
    const jsonMessage = JSON.stringify(messageObject);
    Office.context.ui.messageParent(jsonMessage);
}

DialogMessageReceived のホストページハンドラーは、この例のように dialog.close を呼び出します (dialog オブジェクトを初期化する方法を示す前述の例を参照してください)。

function processMessage(arg) {
    const messageFromDialog = JSON.parse(arg.message);
    if (messageFromDialog.messageType === "dialogClosed") {
       dialog.close();
    }
}

独自の終了ダイアログ UI がない場合でも、エンドユーザーは右上隅にある X を選択してダイアログボックスを閉じることができます。この操作により DialogEventReceived イベントがトリガーされます。イベントがトリガーされたときに、ホストウィンドウに通知する必要がある場合、ホストウィンドウはこのイベントのハンドラーを宣言する必要があります。詳細については、「ダイアログボックスでのエラーとイベント」セクションを参照してください。

コードサンプル

次のサンプルでは、すべてを使用 displayDialogAsyncします。 NodeJS ベースのサーバーがあるサーバーもあれば、ASP.NET/IIS-based サーバーを持つサーバーもありますが、アドインのサーバー側の実装方法に関係なく、メソッドを使用するロジックは同じです。

Office アドインで Office ダイアログ API を使用する

ホストページからダイアログボックスを開く

Office on the web のパフォーマンスオプションを利用する

ダイアログボックスからホストページに情報を送信する

条件付きのメッセージング

ホストランタイムへのクロスドメインメッセージング

情報をダイアログボックスに渡す

ホストページからを使用 `messageChild()` する

ダイアログボックスで DialogParentMessageReceived を処理する

親ページからダイアログボックスへの条件付きメッセージング

ダイアログランタイムへのクロスドメインメッセージング

ダイアログボックスを閉じる

コードサンプル

関連項目

フィードバック

その他のリソース

Office アドインで Office ダイアログ API を使用する

ホスト ページからダイアログ ボックスを開く

Office on the web のパフォーマンス オプションを利用する

ダイアログ ボックスからホスト ページに情報を送信する

条件付きのメッセージング

ホスト ランタイムへのクロスドメイン メッセージング

情報をダイアログ ボックスに渡す

ホスト ページからを使用 messageChild() する

ダイアログ ボックスで DialogParentMessageReceived を処理する

親ページからダイアログ ボックスへの条件付きメッセージング

ダイアログ ランタイムへのクロスドメイン メッセージング

ダイアログ ボックスを閉じる

コード サンプル

関連項目

フィードバック

その他のリソース

ホストページからダイアログボックスを開く

Office on the web のパフォーマンスオプションを利用する

ダイアログボックスからホストページに情報を送信する

ホストランタイムへのクロスドメインメッセージング

情報をダイアログボックスに渡す

ホストページからを使用 `messageChild()` する

ダイアログボックスで DialogParentMessageReceived を処理する

親ページからダイアログボックスへの条件付きメッセージング

ダイアログランタイムへのクロスドメインメッセージング

ダイアログボックスを閉じる

コードサンプル