Editing in Windows Forms Spreadsheet

9 Oct 20237 minutes to read

This section explains about the Editing behavior, Data Validation and Hyperlinks in Spreadsheet.

Cell Editing

The Spreadsheet control provides support for editing, you can modify and commit the cell values in the workbook.

By default, Editing will be enabled in Spreadsheet,but if you want to disable the editing in Spreadsheet, then set the AllowEditing Property to be false.

void spreadsheet_WorkbookLoaded(object sender, WorkbookLoadedEventArgs args)
{
    spreadsheet.ActiveGrid.AllowEditing = false;
}

Editing a cell programmatically

Start editing

User can edit a cell programmatically by using BeginEdit method.

spreadsheet.ActiveGrid.CurrentCell.BeginEdit(true);

End editing

User can end the editing of a cell programmatically in any of the following way,

  • ValidateAndEndEdit - Validates and ends the edit operation for the current cell. if the cancel is “true”, then the current cell remains in edit mode else if the validation is true, commits the new value and moved to next cell or else if the validation is false, it reverts the old value and moved to next cell.

  • EndEdit - Commits and ends the edit operation for the current cell, if it is passed with parameter “true”, commits the new changes for the cell, else reverts the old value.

//Validates and end the edit operation,
spreadsheet.ActiveGrid.CurrentCell.ValidateAndEndEdit();

//Commits the value and end the edit operation,
spreadsheet.ActiveGrid.CurrentCell.EndEdit(true);

Locking or unlocking a cell

Locking cells allows you to disable editing and formatting the cells when the sheet is protected. By default, every cells are locked in the worksheet.
But while in protect mode, if you want to edit or format a cell, you can unlock the cells.

var worksheet = spreadsheet.ActiveSheet;
var excelStyle = worksheet.Range["A2"].CellStyle;

//To unlock a cell,           
excelStyle.Locked = false;

//To lock a cell, 
excelStyle.Locked = true;

Properties, Methods, and Events

The order of events when editing and committing a cell value in Spreadsheet,

Events Description

CurrentCellBeginEdit

Occurs when the current cell enters into edit mode. This event allows to cancel entering the edit mode.

CurrentCellValueChanged

Occurs when the current cell value is changed in edit mode.

CurrentCellValidating

Occurs when the current cell value is going to be validated. It allows you to validate and cancel the end editing.

CurrentCellValidated

Occurs after the current cell is validated.

CurrentCellEndEdit

Occurs when the current cell leaves from edit mode.

Below table list the properties associated with Editing.

Properties Description

AllowEditing

Gets or sets the value indicating whether to allow the editing operation or not.

EditorSelectionBehavior

Gets or sets a value indicating whether editor select all the value or move last position.

EditTrigger

Gets or sets a value indicating any of the trigger options will cause cells to enter Edit Mode.

IsEditing

Gets whether the current cell is in edit mode or not.

Below table list the methods associated with Editing.

Methods Description

BeginEdit

Begins the editing operation of the current cell and returns true if the current cell enters into edit mode.

EndEdit

Commits and ends the edit operation of the current cell.

ValidateAndEndEdit

Validates and ends the edit operation of the current cell.

Validate

Validates the current cell in the SpreadsheetGrid.

Data Validation

Data Validation is a list of rules to limit the type of data or the values that can be entered in the cell.

Applying data validation at runtime

Spreadsheet allows the user to apply the data validation rules at runtime for particular cell or range using IDataValidation interface.

//Number Validation
IDataValidation validation = spreadsheet.ActiveSheet.Range["A5"].DataValidation;
validation.AllowType = ExcelDataType.Integer;
validation.CompareOperator = ExcelDataValidationComparisonOperator.Between;
validation.FirstFormula = "4";
validation.SecondFormula = "15";
validation.ShowErrorBox = true;
validation.ErrorBoxText = "Accepts values only between 4 to 15";

//Date Validation
IDataValidation validation = spreadsheet.ActiveSheet.Range["B4"].DataValidation;
validation.AllowType = ExcelDataType.Date;
validation.CompareOperator = ExcelDataValidationComparisonOperator.Greater;
validation.FirstDateTime = new DateTime(2016,5,5);
validation.ShowErrorBox = true;
validation.ErrorBoxText = "Enter the date value which is greater than 05/05/2016";

//TextLength Validation
IDataValidation validation = spreadsheet.ActiveSheet.Range["A3:B3"].DataValidation;
validation.AllowType = ExcelDataType.TextLength;
validation.CompareOperator = ExcelDataValidationComparisonOperator.LessOrEqual;
validation.FirstFormula = "4";
validation.ShowErrorBox = true;
validation.ErrorBoxText = "Text length should be lesser than or equal 4 characters";

//List Validation
IDataValidation validation = spreadsheet.ActiveSheet.Range["D4"].DataValidation;
validation.ListOfValues = new string[] { "10", "20", "30" };

//Custom Validation
IDataValidation validation = spreadsheet.ActiveSheet.Range["D4"].DataValidation;
validation.AllowType = ExcelDataType.Formula;
validation.FirstFormula = "=A1+A2>0";
validation.ErrorBoxText = "Sum of the values in A1 and A2 should be greater than zero";

For more reference, please go through the XlsIO UG.

TIPS

If you want to load ComboBox to a cell in Spreadsheet, you can apply List Validation to that cell.

The Hyperlink is a convenient way to access the web pages, files and browse the data within a worksheet or other worksheets in a workbook. Spreadsheet provides support to add, edit and remove the Hyperlinks in the workbook.

Spreadsheet provides support to add hyperlink to a cell and it can be added in the hyperlinks collection using IHyperlinks interface.

Spreadsheet allows you to add below types of the hyperlink.

  • Web URL
  • Cell or range in workbook
  • E-mail
  • External files
// Creating a Hyperlink for e-mail,
var range = spreadsheet.ActiveSheet.Range["A5"];
IHyperLink hyperlink1 = spreadsheet.ActiveSheet.HyperLinks.Add(range);
hyperlink1.Type = ExcelHyperLinkType.Url;
hyperlink1.Address = "mailto:Username@syncfusion.com";
hyperlink1.TextToDisplay="Send Mail";
spreadsheet.ActiveGrid.InvalidateCell(GridRangeInfo.Cell(5, 1));

// Creating a Hyperlink for Opening Files,
var range1 = spreadsheet.ActiveSheet.Range["D5"];
IHyperLink hyperlink2 = spreadsheet.ActiveSheet.HyperLinks.Add(range1);
hyperlink2.Type = ExcelHyperLinkType.File;
hyperlink2.Address = @"C:\Samples\Local";
hyperlink2.TextToDisplay = "File Location";
spreadsheet.ActiveGrid.InvalidateCell(GridRangeInfo.Cell(5, 4));

//Creating a Hyperlink to refer another cell in the workbook,
var range2 = spreadsheet.ActiveSheet.Range["C13"];
IHyperLink hyperlink3 = spreadsheet.ActiveSheet.HyperLinks.Add(range);
hyperlink3.Type = ExcelHyperLinkType.Workbook;
hyperlink3.Address = "Sheet2!C23";
hyperlink3.TextToDisplay = "Sample";
spreadsheet.ActiveGrid.InvalidateCell(GridRangeInfo.Cell(13, 3));

Spreadsheet provides support to edit or remove the hyperlinks from the range by accessing Hyperlinks collection.

//To Edit a hyperlink in a cell,
var hyperlink = spreadsheet.ActiveSheet.Range["A5"].Hyperlinks[0];
hyperlink.TextToDisplay = "Sample";
hyperlink.Address = "http://help.syncfusion.com";
spreadsheet.ActiveGrid.InvalidateCell(GridRangeInfo.Cell(5,1));

//To remove a hyperlink in a cell,
var hyperlink = spreadsheet.ActiveSheet.Range["A5"].Hyperlinks.RemoveAt(0);
spreadsheet.ActiveGrid.InvalidateCell(GridRangeInfo.Cell(5,1));