Ewa.EwaControl.add_activeSelectionChanged(function)

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

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

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

Ewa.EwaControl.add_activeSelectionChanged(function);

パラメーター

function

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

戻り値

None.

注釈

**[Ewa.EwaControl.add_activeSelectionChanged]**メソッドは、イベント ハンドラー **[activeSelectionChanged]**イベントを購読します。現在の選択範囲が変更されたときに、 **[activeSelectionChanged]**イベントが発生します。

注意

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

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

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

例

次の例では、イベント ハンドラー **[activeSelectionChanged]**イベントを購読します。コードでは、 **[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", ewaOnPageLoad);
}

if (window.attachEvent)
{
    window.attachEvent("onload", ewaOnPageLoad);
}

// Add event handler for applicationReady event.
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 
    // activeSelectionChanged event.
    ewa.add_activeSelectionChanged(selectionChanged);
    // ...
}

// Handle the activeSelectionChanged event.
function selectionchanged(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();
}

</script>

関連項目

参照先

Ewa.EwaControl.remove_activeSelectionChanged(function)

Ewa.EwaControl オブジェクト