Ewa.RangeEventArgs.getRange()
Applies to: apps for SharePoint | Excel Services | SharePoint Server 2013
In this article
Return Value
Remarks
Example
Applies To
Gets the Ewa.Range that is applicable to the event.
var value = Ewa.RangeEventArgs.getRange();
Return Value
Type: Ewa.Range
Remarks
The [Ewa.RangeEventArgs.getRange] method returns the range that is associated with an event.
Example
The following code example shows how to subscribe an event handler to the activeCellChanged event. The code also shows how to use [Ewa.RangeEventArgs.getRange] to get the range associated with the event. The code example assumes that you are working with an Excel Web Access Web Part on SharePoint Server 2013.
<script type="text/javascript">
var ewa = null;
// Run the Excel load handler on page load
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.");
}
// Add your code here.
}
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);
// Add your code here.
}
// 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();
// Use getFormattedValues to return the value of the changed cell.
var value = rangeArgs.getFormattedValues();
alert("The active cell is located at row " + (row + 1) + " and column " + (col + 1) + " with value " + value + ".");
// Add your code here.
}
</script>