PageCanvas.ConvertToDrawingLayoutUnits(Int32, DocumentLayoutUnit) Method

Converts an object’s measurement units to the specified ones.

Namespace: DevExpress.XtraRichEdit.API.Layout

Assembly: DevExpress.RichEdit.v24.1.Core.dll

NuGet Packages: DevExpress.RichEdit.Core, DevExpress.Win.Navigation

Declaration

C#

public int ConvertToDrawingLayoutUnits(
    int value,
    DocumentLayoutUnit unit
)

VB.NET

Public Function ConvertToDrawingLayoutUnits(
    value As Integer,
    unit As DocumentLayoutUnit
) As Integer

Parameters

Name	Type	Description
value	Int32	The Int32 value that will be converted to the specified measurement unit.
unit	DocumentLayoutUnit	Specifies measurement units for conversion.

Returns

Type	Description
Int32	The Int32 value that is original integer value converted to the specified measurement unit.

Remarks

When you print or export documents, document objects may appear differently from the way they look on screen. To make them look the same both in Print Preview and display outputs, set the DocumentLayoutUnit parameter to the same DocumentLayoutUnit value as the one specified for the document layout.

Note

This method is effective only if the drawn shape has coordinates and parameters represented by absolute values. There is no need to convert parameters represented by relative values – they are already measured in the same unit as the document layout.

Example

This code snippet illustrates the implementation of the PageCanvas.ConvertToDrawingLayoutUnits method.

In this example, a custom colored rectangle is drawn. The PageCanvas.ConvertToDrawingLayoutUnits method converts its parameters to the same measurement units as the one specified for the document layout. It makes the drawn figure appear the same in Print Preview and on the display:

If the method is not used and the rectangle’s parameters are not converted, it will appear as illustrated below:

View Example

MyLayoutPainter.vb

Public Overrides Sub DrawPage(ByVal page As LayoutPage)
    If Form1.customDrawPage = True Then
        Dim inlineRect As New Rectangle(100, 100, 150, 200)
        Canvas.DrawRectangle(New RichEditPen(Color.Aquamarine, Canvas.ConvertToDrawingLayoutUnits(4, DocumentLayoutUnit.Pixel)), Canvas.ConvertToDrawingLayoutUnits(inlineRect, DocumentLayoutUnit.Pixel))

    End If
    MyBase.DrawPage(page)
End Sub

MyLayoutPainter.cs

public override void DrawPage(LayoutPage page)
{
    if (Form1.customDrawPage == true)
    {
        Rectangle inlineRect = new Rectangle(100, 100, 150, 200);
        Canvas.DrawRectangle(new RichEditPen(Color.Aquamarine, Canvas.ConvertToDrawingLayoutUnits(4, DocumentLayoutUnit.Pixel)), Canvas.ConvertToDrawingLayoutUnits(inlineRect, DocumentLayoutUnit.Pixel));

    }
    base.DrawPage(page);
}

Related GitHub Examples

The following code snippet (auto-collected from DevExpress Examples) contains a reference to the ConvertToDrawingLayoutUnits(Int32, DocumentLayoutUnit) method.

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#

winforms-richedit-layout-api/CS/LayoutApiSimpleExample/MyLayoutPainter.cs#L30

Rectangle bounds = floatingPicture.Bounds;
Point startPoint = new Point(bounds.X + Canvas.ConvertToDrawingLayoutUnits(10, DocumentLayoutUnit.Pixel), bounds.Y + bounds.Height - Canvas.ConvertToDrawingLayoutUnits(40, DocumentLayoutUnit.Pixel));
RichEditPen pEn = new RichEditPen(Color.Coral);

VB.NET

winforms-richedit-layout-api/VB/LayoutApiSimpleExample/MyLayoutPainter.vb#L26

Dim bounds As Rectangle = floatingPicture.Bounds
Dim startPoint As New Point(bounds.X + Canvas.ConvertToDrawingLayoutUnits(10, DocumentLayoutUnit.Pixel), bounds.Y + bounds.Height - Canvas.ConvertToDrawingLayoutUnits(40, DocumentLayoutUnit.Pixel))
Dim pEn As New RichEditPen(Color.Coral)