add_commitCellEditing(function)
Applies to: apps for SharePoint | Excel Services | SharePoint Server 2013
In this article
Return Value
Remarks
Example
Subscribes an event handler to the [commitCellEditing] event.
Ewa.EwaControl.add_commitCellEditing(function);
Parameters
function
The event handler to subscribe to the event.
Return Value
None.
Remarks
The Ewa.EwaControl.add_commitCellEditing method subscribes an event handler to the commitCellEditing event. The commitCellEditing event fires when the focus is moved from the cell being edited to another cell or range; that is, when the user has committed the cell edit by moving to a new cell or range.
When the specified event handler for the commitCellEditing event is invoked, it is invoked with a single argument of type Ewa.RangeEditEventArgs. You use the Ewa.RangeEditEventArgs to get references to other objects related to a given instance of the commitCellEditing event, and to get data, including the value of the cell before editing and the value after editing the cell. Additionally, the Ewa.RangeEditEventArgs provides the setTargetUnformattedValue method that you can use to set a value in the cell that is being edited.
Example
The following code example subscribes an event handler to the commitCellEditing event. The code also shows how to use the Ewa.RangeEditEventArgs to get information about the specified range. 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;
// 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 = "Set via code";
// Set the value of the cell via code
rangeEditArgs.setTargetUnformattedValue(o);
} // End ewaCommitCellEditing
</script>