XRConvert Class

Enables you to convert value types and adjust values to different measure units.

Namespace: DevExpress.XtraReports.UI

Assembly: DevExpress.Printing.v18.1.Core.dll

Declaration

C#

public class XRConvert :
    GraphicsUnitConverter

VB.NET

Public Class XRConvert
    Inherits GraphicsUnitConverter

Example

This example illustrates how to adjust the document margins from one DPI value (corresponding to tenths of a millimeter) to another (corresponding to device-independent pixels) by using the XRConvert.ConvertMargins method.

C#

using DevExpress.XtraPrinting;
using DevExpress.XtraReports.UI;
// ...

void ConvertMargins(){ 
printableComponentLink.Margins = XRConvert.ConvertMargins(printableComponentLink.Margins, 
    GraphicsDpi.TenthsOfAMillimeter, 
    GraphicsDpi.DeviceIndependentPixel);
}

VB.NET

Imports DevExpress.XtraPrinting
Imports DevExpress.XtraReports.UI
' ...

Private Sub ConvertMargins()
    printableComponentLink.Margins = XRConvert.ConvertMargins(printableComponentLink.Margins, _ 
    GraphicsDpi.TenthsOfAMillimeter, _ 
    GraphicsDpi.DeviceIndependentPixel)
End Sub

Related GitHub Examples

The following code snippets (auto-collected from DevExpress Examples) contain references to the XRConvert class.

Note

The algorithm used to collect these code examples remains a work in progress. Accordingly, the links and snippets below may produce inaccurate results. If you encounter an issue with code examples below, please use the feedback form on this page to report the issue.

C#

Reporting_how-to-create-a-label-report-at-runtime-t473792/CS/dxWinFormsSample/LabelReportRuntime/CustomLabelReportBuilder.cs#L39

float labelDpi = GraphicsDpi.UnitToDpi(model.MeasurementUnit);
int top = (int)XRConvert.Convert(model.TopMargin, labelDpi, report.Dpi);
int left = (int)XRConvert.Convert(model.LeftMargin, labelDpi, report.Dpi);

how-to-create-a-custom-exporter-for-the-pivotgridcontrol-by-using-the-xtrareport-suite-this-e2231/CS/Report_at_Runtime/PivotReportGenerator.cs#L309

}
optimalColumnWidth.Add(Convert.ToInt32(XRConvert.Convert(maxWidth, GraphicsUnit.Pixel, GraphicsUnit.Inch) * 100 + 1));
for (int i = 1; i < dataTable.Columns.Count; i++)

Reporting_how-to-extend-the-odd-even-detail-band-style-to-a-page-footer-e263/CS/Styling_With_FillEmptySpace/XtraReport1.cs#L24

Size labelSize = new Size(this.dummyDetailBandLabel.Width, this.dummyDetailBandLabel.Height);
Size targetSizeInPixels = XRConvert.Convert(targetSize, GraphicsDpi.HundredthsOfAnInch, GraphicsDpi.Pixel);
Size labelSizeInPixels = XRConvert.Convert(labelSize, GraphicsDpi.HundredthsOfAnInch, GraphicsDpi.Pixel);

how-to-create-a-custom-exporter-that-supports-autorowheight-bestfit-and-fittopage-t274241/CS/WpfApplication31/PivotReportGenerator.cs#L287

}
optimalColumnWidth.Add(Convert.ToInt32(XRConvert.Convert(maxWidth, GraphicsUnit.Pixel, GraphicsUnit.Inch) * 100 + 1));
for(int i = 1; i < dataTable.Columns.Count; i++) {

VB.NET

Reporting_how-to-create-a-label-report-at-runtime-t473792/VB/dxWinFormsSample/LabelReportRuntime/CustomLabelReportBuilder.vb#L40

Dim labelDpi As Single = GraphicsDpi.UnitToDpi(model.MeasurementUnit)
Dim top As Integer = CInt((XRConvert.Convert(model.TopMargin, labelDpi, report.Dpi)))
Dim left As Integer = CInt((XRConvert.Convert(model.LeftMargin, labelDpi, report.Dpi)))

how-to-create-a-custom-exporter-for-the-pivotgridcontrol-by-using-the-xtrareport-suite-this-e2231/VB/Report_at_Runtime/PivotReportGenerator.vb#L287

Next i
optimalColumnWidth.Add(Convert.ToInt32(XRConvert.Convert(maxWidth, GraphicsUnit.Pixel, GraphicsUnit.Inch) * 100 + 1))
For i As Integer = 1 To dataTable.Columns.Count - 1

Reporting_how-to-extend-the-odd-even-detail-band-style-to-a-page-footer-e263/VB/Styling_With_FillEmptySpace/XtraReport1.vb#L26

Dim labelSize As New Size(Me.dummyDetailBandLabel.Width, Me.dummyDetailBandLabel.Height)
Dim targetSizeInPixels As Size = XRConvert.Convert(targetSize, GraphicsDpi.HundredthsOfAnInch, GraphicsDpi.Pixel)
Dim labelSizeInPixels As Size = XRConvert.Convert(labelSize, GraphicsDpi.HundredthsOfAnInch, GraphicsDpi.Pixel)

how-to-create-a-custom-exporter-that-supports-autorowheight-bestfit-and-fittopage-t274241/VB/WpfApplication31/PivotReportGenerator.vb#L296

Next i
optimalColumnWidth.Add(Convert.ToInt32(XRConvert.Convert(maxWidth, GraphicsUnit.Pixel, GraphicsUnit.Inch) * 100 + 1))
For i As Integer = 1 To dataTable.Columns.Count - 1

Inheritance

Object

GraphicsUnitConverter

XRConvert