[Expand]General Information
[Collapse]WinForms Controls
  .NET Core Support
 [Expand]What's Installed
 [Expand]Build an Application
 [Collapse]Controls and Libraries
  [Expand]Forms and User Controls
  [Expand]Messages, Notifications, and Dialogs
  [Expand]Editors and Simple Controls
  [Expand]Ribbon, Bars and Menu
  [Expand]Application UI Manager
  [Expand]Docking Library
  [Expand]Data Grid
  [Expand]Vertical Grid
  [Expand]Property Grid
  [Expand]Pivot Grid
  [Expand]Tree List
  [Expand]Gantt Control
  [Expand]Chart Control
  [Expand]Map Control
   [Expand]Product Information
    Product Structure
    Getting Started
   [Collapse]Spreadsheet Document
     Cells and Cell Ranges
     Rows and Columns
     Measure Units
    Supported Formats
   [Expand]Cell Basics
    Defined Names
    Data Binding
    Data Validation
   [Expand]Data Presentation
    Data Grouping
   [Expand]Pivot Tables
   [Expand]Charts and Graphics
   [Expand]Mail Merge
    Operation Restrictions
    Find and Replace
   [Expand]Visual Elements
   [Expand]Keyboard Shortcuts
  [Expand]Rich Text Editor
  [Expand]Spell Checker
  [Expand]Form Layout Managers
  [Expand]Navigation Controls
  [Expand]PDF Viewer
  [Expand]TreeMap Control
  [Expand]Sunburst Control
 [Expand]Common Features
  Get More Help
 [Expand]API Reference
[Expand]ASP.NET Controls and MVC Extensions
[Expand]ASP.NET Bootstrap Controls
[Expand]ASP.NET Core Bootstrap Controls
[Expand]WPF Controls
[Expand]Xamarin Controls
[Expand]Windows 10 App Controls
[Expand]Office File API
[Expand]Report and Dashboard Server
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Measure Units

The XtraSpreadsheet allows you to select a unit of measurement for various distance values of a workbook (such as column width, row height and page margins). To set a single unit of measurement, use the SpreadsheetControl.Unit property or the Unit property of the IWorkbook object returned by SpreadsheetControl.Document.

Unit of Measurement


How to Use


Document (1 document unit is equal to 1/300 of an inch). This is a default measure unit of a workbook.

Set the Unit property to DocumentUnit.Document.


Centimeter (1 inch is equal to 2.54 centimeters)

Set the Unit property to DocumentUnit.Centimeter.


Millimeter (10 millimeters are equal to 1 centimeter)

Set the Unit property to DocumentUnit.Millimeter.



Set the Unit property to DocumentUnit.Inch.


Point (1 inch is equal to 72 points)

Set the Unit property to DocumentUnit.Point.


Pixel (1 inch is equal to 96 pixels). You can use this unit to set column width.

Use the following properties to set column width in pixels.




Character (the width of the zero character in the font specified by the built-in Normal style). You can use this unit to set column width.

Use the following properties to set column width in characters.




A workbook's units of measurement specified by the Unit property are used in the following cases.

Expanded See Also

Is this topic helpful?​​​​​​​