[Expand]General Information
[Expand]WinForms Controls
[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
[Collapse]Reporting
 [Expand]Product Information
 [Expand]Get Started with DevExpress Reporting
 [Expand]Create Popular Reports
 [Collapse]Detailed Guide to DevExpress Reporting
   Introduction to Banded Reports
  [Expand]Provide Data to Reports
  [Expand]Use Report Controls
  [Expand]Shape Report Data
   Arrange Dynamic Report Contents
  [Expand]Customize Appearance
  [Expand]Add Navigation
  [Expand]Provide Interactivity
  [Expand]Add Extra Information
  [Expand]Merge Reports
  [Expand]Use Expressions
  [Collapse]Store and Distribute Reports
    Reporting Security
   [Expand]Store Report Layouts and Documents
   [Collapse]Globalize and Localize Reports
     Report Units of Measurement
     Right-To-Left Support
   [Expand]Export Reports
    Print Reports
  [Expand]Reporting API
 [Expand]Visual Studio Report Designer
 [Expand]Create End-User Reporting Applications
 [Expand]API Reference
[Expand]Report and Dashboard Server
[Expand]Dashboard
[Expand]eXpressApp Framework
[Expand]eXpress Persistent Objects
[Expand]CodeRush
[Expand]CodeRush Classic
[Expand]Cross-Platform Core Libraries
[Expand]Tools and Utilities
 End-User Documentation
View this topic on docs.devexpress.com (Learn more)

Report Units of Measurement

This topic describes the systems of measurement (Imperial, Metric or Screen) that can be assigned to a report to present values in a uniform manner (e.g., element locations, dimensions and margins).

Expanded Supported Systems of Measurement

Most metrics of report elements (i.e., element locations, dimensions and margins) can be expressed in units that correspond to one of the following systems of measurement.

  • Imperial system (in hundredths of an inch)

    This is the default system that is assigned to each new report, as well as to controls that have been created in code, but have not yet been added to a report (in this case, the XRControl.RootReport property of these controls returns null in C# or Nothing in Visual Basic).

  • Metric system (in tenths of a millimeter)
  • Screen coordinates (in pixels)

To assign a system of measurements to a report, use its XtraReport.ReportUnit property.

Changing the system of measurement results in converting the corresponding property values and updating the layout of all report elements in the Report Designer. Notably, the system of measurement determines the minimum increment with which an element's location and size can be changed, which is specified by the XtraReport.SnapGridSize property.

When specifying a control's dimensions in code, make sure that these values agree with the measurement units that are currently assigned to a report.

Expanded Affected Properties

To maintain a high standard of printing, the border width of an element is always measured in pixels, which only applies to the XRControl.BorderWidth and XRZipCode.SegmentWidth property values. When publishing a report, these values are converted to its unit of measurement based on the XRControl.Dpi property value.

The values of the following properties are expressed in the measurement units assigned to the XtraReport.ReportUnit property.

Properties

Description

XtraReport.SnapGridSize

Determines the scale of the snap grid, which provides effortless alignment of elements in a Report Designer.

XRControl.BoundsF

Specifies both the dimensions and location of an element.

XRControl.SizeF

XRControl.HeightF

XRControl.WidthF

Specify an element's dimensions.

XRControl.LocationF

XRControl.BottomF

XRControl.LeftF

XRControl.RightF

XRControl.TopF

Specify an element's location.

XtraReport.PageHeight

XtraReport.PageWidth

Specify the dimensions of report pages.

XtraReport.Margins

Specifies the page margins of a report.

MultiColumn.ColumnWidth

MultiColumn.ColumnSpacing

Specify the width of report columns and the spacing between them.

XRLine.LineWidth

XRShape.LineWidth

Specify the line width of the Line and Shape controls.

XRBarCode.Module

Specifies the width of the narrowest module (a bar or white space) in a bar code.

XRCrossBandControl.StartPointF

XRCrossBandControl.EndPointF

Specify the start and end coordinates of a cross-band control.

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