Ewa.EwaControl.add_activeCellChanged(function)

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

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

イベント ハンドラー **[activeCellChanged]**イベントを購読します。

Ewa.EwaControl.add_activeCellChanged(function);

パラメーター

function

イベントを購読するイベント ハンドラー。

戻り値

None.

注釈

Ewa.EwaControl.add_activeSelectionChangedメソッドは、イベント ハンドラー activeCellChangedイベントを購読します。(マウス選択、方向キー、return キー、およびなど) をアクティブ セルが変更されたときに、 activeCellChangedイベントが発生します。

注意

activeCellChangedイベントは、 activeSelectionChangedイベントとは異なります。アクティブ セルは、キーボードから入力を受け取るセルです。現在の選択範囲は、現在選択されているセルの範囲です。作業中の範囲が同じで、アクティブ セルを変更できます。

たとえば、選択した範囲は、アクティブ セルの変更は、選択範囲内] タブの [キーを押したときにそのまま残ります。

activeCellChangedイベントの指定したイベント ハンドラーが呼び出されるEwa.RangeEventArgsタイプの 1 つの引数が呼び出されます。Ewa.RangeEventArgsオブジェクトには、 activeCellChangedイベントに関連付けられたEwa.Rangeオブジェクトに関する情報が含まれています。

例

次の例では、イベント ハンドラー activeCellChangedイベントを購読します。コードでは、 Ewa.RangeEventArgsを使用して、指定した範囲に関する情報を入手する方法も表示されます。コードの例を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", ewaOmPageLoad);    
} 
else 
{ 
    window.addEventListener("DOMContentLoaded", ewaOmPageLoad, 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_activeCellChanged(cellChanged);

    // ...
}

// Handle the active cell changed event.
function cellChanged(rangeArgs)
{
    // Use the RangeEventArgs object to get information about the range.
    var sheetName = rangeArgs.getRange().getSheet().getName();
    var col = rangeArgs.getRange().getColumn();
    var row = rangeArgs.getRange().getRow();
    var value = rangeArgs.getFormattedValues();
    alert("The active cell is located at row " + (row + 1) + " andcolumn " + (col + 1) + " with value " + value + ".");
    // ...
}

</script>

関連項目

参照先

Ewa.EwaControl オブジェクト