Measure Units - ImpactV7

Help & Support

Durkin Computing, act! CRM by Swiftypage

Contents

Display Legacy Contents

Search:

Home > Report Designer > Getting Started > Measure Units

Measure Units

Home > Report Designer > Getting Started > Measure Units

Measure Units

This document describes what measure units are supported by XtraReports and how to change the currently used system of measurement for a particular report.

Supported Measure Units

All sizes and locations of report controls, bands and the report itself are measured in the same units of measurement within a report. This unit of measurement is specified by a report's ReportUnit property and can be set to one of the following types.

Hundredths of an inch.
Used when the ReportUnit property is set to HundredthsOfAnInch.
Tenth of a millimeter.
Used when the ReportUnit property is set to TenthsOfAMillimeter.

The table below lists all properties that are measured in units, specified by a report's ReportUnit property.

Property	Short Description
Height	Gets or sets the control's height.
Width	Gets or sets the control's width.
Left	Gets or sets the X-coordinate of the control's left edge.
Top	Gets or sets the Y-coordinate of the control's top edge.
Bottom	Gets the Y-coordinate of the control's bottom edge.
Right	Gets the X-coordinate of the control's right edge.
Band Height	Gets or sets the control's or band's height.
LineWidth	Gets or sets the line width.
LineWidth	Gets or sets the width of the line which is used to draw the shape image.
Module	Gets or sets the width of the narrowest bar or space in the current XRBarCode instance.
StartPoint	Gets or sets the starting point where the cross-band control starts drawing.
EndPoint	Gets or sets the ending point where the control ends drawing.
PageHeight	Gets or sets the height of the report's pages.
PageWidth	Gets or sets the width of the report's pages.
Margins	Gets or sets the margins of the report's pages.
ColumnWidth	Gets or sets the widths of the columns when printing multi-column reports.
ColumSpacing	Gets or sets the amount of space between the columns when multi-column reports are printed.

Note that although most sizes in XtraReports are measured in a report's measure units, some properties are still measured in pixels to provide better quality of the resulting report, both on printing and exporting it. The set of exceptional properties include XRControl.BorderWidth, XRCrossBandBox.BorderWidth and XRZipCode.SegmentWidth. So, these properties are always stored in pixels, but are converted to the current units of measurement when creating a report using the current XRControl.Dpi property value.

For example, the specified measure unit affects the behavior of the XtraReport.SnapGridSize property and the minimum step in which report elements can be moved or resized. For details on this, refer to Controls Positioning.Fundamentals.

Changing the Current Measure Unit

By default, the XtraReport.ReportUnit property is set to ReportUnit.HundredthsOfAnInch for every new report. However, you may easily change the current unit of measurement by locating this property in the Property Grid and setting it to ReportUnit.TenthsOfAMillimeter.

Note that every time a report's unit of measurement is changed, all properties that are measured in report units, re-calculate their values. This is required to maintain the report layout at design time. Therefore, if you specify a control's height or width at runtime, you need to manually take care of the report units where height and width will be measured.

Notably, the specified measure unit affects the XtraReport.SnapGridSize property, and the minimum step in which report elements can be moved or resized. For details on this, refer to Controls Positioning.