The One With

WinForms Spreadsheet Control – New API

In the recent release v2013.1 of the DevExpress WinForms Subscription, we introduced a brand new Spreadsheet Control. We are hard at work adding features to it and in v13.1.5 we’ve added new API to make working with the spreadsheet even easier.

New Cells API


v  The CellValue.IsDateTime property indicates whether a cell contains a DateTime value.

v  The Cell.IsDisplayedAsDateTime property indicates whether a number contained in a cell is displayed as a DateTime. This eliminates the need for checking cell value and format.

v  Assigning a DateTime to a Cell.Value results in an automatic formatting of the value as a DateTime.

v  To clear cell value, you can now assign it to null, e.g. Cell.Value = null

v  The Cell.Value property can be assigned various object  types. Built-in converters are responsible for correct interpretation and type conversion. The following methods have now been implemented: CellValue.ToObject, CellValue.FromObject, CellValue.TryCreateFromObject.

New Workbooks API

v  The Evaluate method gets a string and evaluates it as if it were a cell formula. It can be used to convert a worksheet name to an object or a value.  In the following example, the mass value is calculated by multiplying the value contained in the A1 cell by density (a defined name value), and rounding the result to two decimal places. 

spreadsheetDocument.DefinedNames.Add("density", "13.534");

double mass = spreadsheetControl1.Document.Evaluate("=ROUND(A1*density,2)").NumericValue;

v  The Calculate method recalculates the cells in all worksheets for the current workbook.

v  The following events have been implemented and occur when worksheets, rows or columns are inserted or deleted.

ü  event SheetInserted

ü  event SheetRemoved

ü  event RowsRemoved

ü  event RowsInserted

ü  event ColumnsRemoved

ü  event ColumnsInserted



v  The HasMacros property indicates the presence of macros in a workbook (XLSM file format)

v  The IWorkbook.Range method provides access to the IRangeProvider interface that can parse a string in order to obtain a worksheet’s range:

Range range = spreadsheetControl1.Document.Range["Sheet1!A1:B2"];


Range range = spreadsheetControl1.Document.Range.Parse("Sheet1!A1:B2");


New Worksheet API

v  Worksheet.MaxColumnCount allows you to limit the number of columns in a worksheet

v  Worksheet.MaxRowCount allows  you to limit the number of rows in a worksheet

New DefinedName API

·         DefinedName.Range property gets or sets a worksheet cell or a range marked by the defined name.


Build v13.1.5 is available for immediate download from the Download Manager.



Published Jul 12 2013, 04:07 PM by
Bookmark and Share


Sigurd Decroos

The 'evaluate' is pretty nice.

It would be nice to have a textedit which would have that functionality instead of the calcedit. So only mathematical characters are allowed in this textedit. Perhaps with dropdown to a calcedit?

August 7, 2013 9:18 PM

Chat is one of the many ways you can contact members of the DevExpress Team.
We are available Monday-Friday between 7:30am and 4:30pm Pacific Time.

If you need additional product information, write to us at or call us at +1 (818) 844-3383


DevExpress engineers feature-complete Presentation Controls, IDE Productivity Tools, Business Application Frameworks, and Reporting Systems for Visual Studio, Delphi, HTML5 or iOS & Android development. Whether using WPF, ASP.NET, WinForms, HTML5 or Windows 10, DevExpress tools help you build and deliver your best in the shortest time possible.

Copyright © 1998-2018 Developer Express Inc.
All trademarks or registered trademarks are property of their respective owners