Ewa.RangeEditEventArgs オブジェクト

  • [アーティクル]

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

イベントの特定のインスタンスに関連するその他のオブジェクトを参照して取得し、関連付けられている範囲に含まれる値などのデータの設定に使用できるオブジェクトです。

Ewa.RangeEditEventArgs

注釈

自体には、範囲への参照を取得するのに、または範囲に含まれるブックへの参照にアクセスするのには、範囲内のセルの値を取得するのにには、 Ewa.RangeEditEventArgsオブジェクトのメソッドを使用します。さらに、 Excel Web Access Web パーツを表すEwa.EwaControl オブジェクトオブジェクトを取得するのにEwa.RangeChangeEventArgs.getEwaControl()メソッドを使用することができます。

例

次の例では、イベント ハンドラー commitCellEditingイベントを購読します。コードでは、 Ewa.RangeEditEventArgsを使用してからデータを取得し、指定した範囲にデータを設定する方法も表示されます。コードの例をExcel Web Access Web パーツでSharePoint Server 2013で作業していることを前提としています。

<script type="text/javascript">
var ewa = null;

// Add event handler for onload event.
if (window.attachEvent) {
    window.attachEvent("onload", ewaOnPageLoad);
}
else {
    window.addEventListener("DOMContentLoaded", ewaOnPageLoad, false);
}

function ewaOnPageLoad() {
    if (typeof (Ewa) != "undefined") {
        Ewa.EwaControl.add_applicationReady(ewaApplicationReady);
    }
    else {
        alert("Error - the EWA JS is not loaded.");
    }
    // ...
}

function ewaApplicationReady() {
    // Get a reference to the Excel Services Web Part.
    ewa = Ewa.EwaControl.getInstances().getItem(0);
    // Add an event handler for the 
    // active cell changed event.
    ewa.add_commitCellEditing(ewaCommitCellEditing);

    // ...
}

function ewaCommitCellEditing(rangeEditArgs) {
    // Get the value of the cell before editing
    var oldValue = rangeEditArgs.getTargetOldUnformattedValue();
    // Get the value of the cell after editing
    var newValue = rangeEditArgs.getTargetUnformattedValue();

    // Display the before and after values of the cell
    alert("Old value: " + oldValue.toString() + "\nNew value: " + newValue.toString());

    var o = new Object();
    o = "Set via code";

    // Set the value of the cell programmatically 
    rangeEditArgs.setTargetUnformattedValue(o);
} // End ewaCommitCellEditing
</script>

関連項目

参照先

Ewa.EwaControl オブジェクト

その他の技術情報

add_commitCellEditing(function)