Share via


Ewa.RangeEventArgs.getFormattedValues()

Applies to: apps for SharePoint | Excel Services | SharePoint Server 2013

In this article
Return Type
Remarks
Example
Applies To

Gets an array of string arrays that contains the formatted values for the cell or range that is associated with the given event.

var value = Ewa.RangeEventArgs.getFormattedValues();

Return Type

Type: string [][]

Remarks

The [Ewa.RangeEventArgs.getFormattedValues] method returns an array of string arrays that contains formatted values that are in the specified range. [Ewa.RangeEventArgs.getFormattedValues] returns null if some or all of the values are not already loaded by the Ewa.EwaControl.

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.getFormattedValues] to get the formatted value of the specified cell. 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> 

Applies To

Ewa.RangeEventArgs Object

See also

Reference

Ewa.RangeEventArgs Methods

Concepts

Ewa namespace