Ewa.EwaControl.loadEwaAsync (済み、divID、embedOptions、コールバック、ユーザー コンテキスト)

**適用対象:**apps for SharePoint | Excel Services | SharePoint Server 2013

この記事の内容
戻り値
注釈
例

ホストの web ページ上の <div> 要素Microsoft Excelブックに埋め込まれます。

var value = Ewa.EwaControl.loadEwaAsync(fileID, divID, embedOptions, callback, userContext);

パラメーター

fileID

ブックを埋め込むの場所を指定する必要なstringします。

注意

Microsoft Excel Online[埋め込み] ダイアログ ボックスには、 Microsoft OneDriveに保存されているファイルのファイルのトークンを取得する唯一確実な方法が用意されています。

Excel Online[埋め込み] ダイアログ ボックスの詳細については、次を参照してください。マッシュ アップの作成: Excel を web アプリケーションに拡張するします。

divID

埋め込まれたブックを表示する] ページで <div> 要素の id を指定する必要なstringします。

embedOptions

省略可能なobjectを名前付きのオブジェクトを一連の外観のオプション、および、埋め込まれたブックの対話機能のオプション セットを指定する 3 つの子オブジェクトが含まれています。このオブジェクトはloadEwaAsyncへの呼び出しに渡されない場合は、既定の外観と対話機能のオプションをブックが読み込まれます。

前述のように、オブジェクトを作成するは、埋め込まれたブックの対話機能と外観の変更に使用する 2 つの子オブジェクトを含めることができます。1 つの子オブジェクトのプロパティを使用して、埋め込まれたブックの表示オプションを設定します。その他の子オブジェクトを使って、埋め込まれたブックの対話形式のオプションを設定します。作成して外観と埋め込まれたブックの対話形式のオプションを設定する 2 つの子オブジェクトにオブジェクトを使用する方法については、このトピックの後半の例を参照してください。表示オプションを設定して、対話機能のオプションを設定する」を使用する特定のプロパティは、次の表に示します。

次の表には、埋め込まれたブックの表示オプションを表すプロパティが表示されます。

注意

trueに既定では、各boolean値を保持するプロパティを設定します。

表 1 します。埋め込まれたブックの表示オプションを指定するためのプロパティ

名前	説明
showDownloadButton	trueには、ブックのダウンロード リンクが表示された場合。
selectedCell	指定したセルを選択します。 > [!NOTE] > 場合は、この設定を無効なセル値に設定は無視されます。 > [!NOTE] > この設定の既定値はありません。
showParametersTaskPane	trueには、[パラメーター] 作業ウィンドウが表示された場合。 > [!IMPORTANT] > trueにこのプロパティを設定がないを有効にするパラメーター] 作業ウィンドウの表示がない場合、ブックに公開されるパラメーターします。
showRowColumnHeaders	true行と列のヘッダーを表示する場合。 > [!IMPORTANT] > trueにこのプロパティの設定もの行と、基になるブックが行の表示を非表示の場合は、埋め込まれたブックの列見出しと列見出しの表示を有効にすることはできません。
showGridlines	true、目盛線を表示する場合。 > [!IMPORTANT] > trueにこのプロパティの設定が場合を有効に、埋め込まれたブックで枠線の表示、基になるブックで枠線の表示を非表示にします。

次の表には、埋め込まれたブックの対話機能のオプションを表すプロパティが表示されます。既定では、各boolean値を保持するプロパティがtrueします。オプションのユーザー インターフェイスを非表示にもfalseにプロパティを設定します。

表 2 します。埋め込まれたブックの対話機能のオプションを指定するためのプロパティ

名前	説明
allowTypingAndFormulaEntry	true、により、数式のエントリを入力して場合。
allowParameterModification	trueパラメーターの変更を有効にする場合。
allowSorting	true、並べ替えを有効にする場合。
allowFiltering	true、フィルター処理を有効にする場合。
allowPivotTableInteractivity	true、ピボット テーブルのすべての対話機能を有効にする場合。
allowHyperlinkNavigation	trueハイパーリンクのナビゲーションを有効にする場合。

callback

非同期操作が完了したらと呼ばれる関数を指定します。

userContext

非同期呼び出しの状態に渡すための方法として提供されているオブジェクトです。

戻り値

None.

注釈

loadEwaAsyncメソッドを使用して、ホストの web ページにOneDriveに保存されているExcelブックを埋め込むことができます。

表示し、外部の web ページで、ブックを操作するプログラムを使用して、作成する必要があり、ホストの web ページの HTML に埋め込みコードを挿入します。ブックを埋め込む、独自のコードを記述することができます埋め込みコードを記述する最も簡単な方法はOneDrive埋め込み] ダイアログ ボックスを使用するには**[埋め込み**] ダイアログ ボックスを使用すると、埋め込みブックでオプションを設定して、自動的にコードを生成する HTML およびECMAScript (JavaScript, JScript)オプションを表示して、ブックの対話機能を指定すると、ブックを埋め込むことができます。[埋め込み] のダイアログ ボックスによって生成されるECMAScript (JavaScript, JScript)コードでは、 loadEwaAsyncメソッドを使用します。

図 1 します。ダイアログ ボックスを埋め込む

さらに、 [埋め込み] ダイアログ ボックスには、 OneDriveに保存されているファイルのファイルのトークンを取得する唯一確実な方法が用意されています。

注意

自動的に埋め込みコードを生成する[埋め込み] ダイアログ ボックスの使用方法について詳しくは、「マッシュ アップの作成: Excel を web アプリケーションに拡張する

例

次の例では、ホストの web ページに Book1.xlsx をというブックに埋め込むloadEwaAsyncメソッドを使用する方法を示します。次の例は、 OneDrive埋め込み] ダイアログ ボックスを使用して生成されました。

<div id="myExcelDiv" style="width: 402px; height: 346px"></div>
<script type="text/javascript" src="http://r.office.microsoft.com/r/rlidExcelWLJS?v=1&kip=1"></script>
<script type="text/javascript">

// Use this file token to reference Book1.xlsx in the Excel APIs.
var fileToken = "SD206C5E037684EDE5!1119/2336345675664780773/";

// Run the Excel load handler on page load.
if (window.attachEvent) {
window.attachEvent("onload", loadEwaOnPageLoad);
} else {
window.addEventListener("DOMContentLoaded", loadEwaOnPageLoad, false);
}

function loadEwaOnPageLoad() {                               
var props = {
                  item: "LunchSales",
uiOptions: {
showGridlines: false,
showRowColumnHeaders: false,
showParametersTaskPane: false
},
interactivityOptions: {
allowTypingAndFormulaEntry: false,
allowParameterModification: false,
allowSorting: false,
allowFiltering: false,
allowPivotTableInteractivity: false
}
};

Ewa.EwaControl. loadEwaAsync(fileToken, "myExcelDiv", props, onEwaLoaded);
}

function onEwaLoaded(result) {

        if (asyncResult.getSucceeded())
        {
            // Use the AsyncResult.getEwaControl() method to get a reference to the EwaControl object
            ewa = asyncResult.getEwaControl();
            ewa.add_activeCellChanged(cellChanged);
        }
        else
        {
            alert("Async operation failed!");
        }
}
</script>

関連項目

参照先

Ewa.EwaControl オブジェクト

その他の技術情報

埋め込まれた Excel ブックの操作で Excel Services JavaScript API を使用