ReportSettingsBase.ReportUnit Property

Specifies units to measure locations, dimensions and margins in the report.

Namespace: DevExpress.XtraReports.UserDesigner

Assembly: DevExpress.XtraReports.v24.1.dll

NuGet Package: DevExpress.Reporting.Core

Declaration

C#

[DefaultValue(ReportUnit.HundredthsOfAnInch)]
public ReportUnit ReportUnit { get; set; }

VB.NET

<DefaultValue(ReportUnit.HundredthsOfAnInch)>
Public Property ReportUnit As ReportUnit

Property Value

Type	Default	Description
ReportUnit	HundredthsOfAnInch	A ReportUnit enumeration value.

Available values:

Name	Description
HundredthsOfAnInch	The unit of measurement is in hundredths of an inch.
TenthsOfAMillimeter	The unit of measurement is in tenths of a millimeter.
Pixels	The unit of measurement is in pixels (one pixel equals 1/96 of an inch).

Remarks

The ReportUnit property specifies the measurement units to use for the contol’s XRControl.SizeF and XRControl.LocationF property types.

Only the XRControl.BorderWidth property value is expressed in ReportUnit.Pixels.

See the Report Units of Measurement topic for a complete list of properties this option affects.

The code sample below illustrates how to create an End-User Designer instance and set the ReportUnit property default value for its reports.

C#

using DevExpress.XtraReports.UI;
using DevExpress.Drawing.Printing;
using DevExpress.XtraReports.UserDesigner;
// ...
XRDesignForm form = new XRDesignForm();
XRDesignMdiController reportDesigner = form.DesignMdiController;
reportDesigner.DefaultReportSettings.PaperKind = DXPaperKind.Letter;
reportDesigner.DefaultReportSettings.Landscape = true;
reportDesigner.DefaultReportSettings.RollPaper = false;
reportDesigner.DefaultReportSettings.ReportUnit = ReportUnit.HundredthsOfAnInch;
reportDesigner.DefaultReportSettings.Margins = new System.Drawing.Printing.Margins(50, 50, 100, 100);
form.ShowDialog();

VB.NET

Imports DevExpress.XtraReports.UI
Imports DevExpress.XtraReports.UserDesigner
' ...
Dim form As New XRDesignForm()
Dim reportDesigner As XRDesignMdiController = form.DesignMdiController
reportDesigner.DefaultReportSettings.PaperKind = DXPaperKind.Letter
reportDesigner.DefaultReportSettings.Landscape = True
reportDesigner.DefaultReportSettings.RollPaper = False
reportDesigner.DefaultReportSettings.ReportUnit = ReportUnit.HundredthsOfAnInch
reportDesigner.DefaultReportSettings.Margins = New System.Drawing.Printing.Margins(50, 50, 100, 100)
form.ShowDialog()