Ewa.RangeChangeEventArgs オブジェクト
**適用対象:**apps for SharePoint | Excel Services | SharePoint Server 2013
、イベントの取得し、関連付けられている範囲に含まれる値などのデータを設定して、特定のインスタンスに関連するその他のオブジェクトの両方を使用できるオブジェクトにアクセスします。
Ewa.RangeChangeEventArgs
注釈
自体には、範囲への参照を取得するのに、または範囲に含まれるブックへの参照にアクセスするのには、範囲内のセルの値を取得するのにには、 Ewa.RangeChangeEventArgsオブジェクトのメソッドを使用します。さらに、 Excel Web AccessExcel Web Access Web パーツを表すEwa.EwaControl オブジェクトオブジェクトを取得するのにEwa.RangeChangeEventArgs.getEwaControl()メソッドを使用することができます。
例
次の例では、イベント ハンドラー dataEnteredイベントを購読する方法を示します。dataEnteredイベントが発生したときに、唯一の引数としてEwa.RangeChangeEventArgsオブジェクトには、各購読しているイベント ハンドラーを呼び出します。コードの例では、 Ewa.RangeChangeEventArgsを使用してイベントに関連付けられている範囲に関する情報を取得する方法を示します。また、コードの例では、 Excel Web Access Web パーツでSharePoint Server 2013で作業していることと仮定します。
<script type="text/javascript">
var ewa = null;
// Run the Excel load handler on page load
if (window.attachEvent) {
window.attachEvent("onload", loadEwaOnPageLoad);
} else {
window.addEventListener("DOMContentLoaded", loadEwaOnPageLoad, false);
}
// Event handler for page load event
function loadEwaOnPageLoad() {
if (typeof (Ewa) != "undefined") {
// Retrieve workbook from SharePoint location when EWA is ready
Ewa.EwaControl.add_applicationReady(ewaApplicationReady);
}
else {
alert("Error - the EWA is not loaded.");
}
// ...
}
function ewaApplicationReady() {
// Get a reference to the EWA web part that represents the Ewa web part
// in SharePoint:
ewa = Ewa.EwaControl.getInstances().getItem(0);
var sheets = ewa.getActiveWorkbook().getSheets();
var sheet;
// Add the event handler to every sheet in the workbook
for (i = 0; i < sheets.getCount(); i++) {
sheet = sheets.getItem(i);
sheet.add_dataEntered(addDataEnteredHandler);
}
}
function addDataEnteredHandler(rangeChangeArgs) {
var sheetName = rangeChangeArgs.getRange().getSheet().getName();
var col = rangeChangeArgs.getRange().getColumn();
var row = rangeChangeArgs.getRange().getRow();
var value = rangeChangeArgs.getFormattedValues();
alert("The range was located at row " + (row + 1) + " and column " + (col + 1) + " with value " + "\"" + value + "\"" + ".");
}
</script>