Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

RichEditControl.LayoutUnit Property

Gets or sets a unit of measure used for a control’s layout. Starting from v18.1, this property has no effect.

Namespace: DevExpress.Xpf.RichEdit

Assembly: DevExpress.Xpf.RichEdit.v24.2.dll

NuGet Package: DevExpress.Wpf.RichEdit

#Declaration

[Browsable(false)]
public DocumentLayoutUnit LayoutUnit { get; set; }

#Property Value

Type Description
DocumentLayoutUnit

One of the DocumentLayoutUnit enumeration values.

The default is DocumentLayoutUnit.Document.

Available values:

Name Description
Document

Specifies documents (one three-hundredths of an inch) as measurement units.

Twip

Specifies twips (1,440 twips equal one inch, and 567 twips equal one centimeter) as measurement units.

Pixel

Specifies pixels as measurement units.

#Remarks

Before v.18.1, a document would not accurately print or properly display on devices with different DPI settings. The issue is caused by different measure units used to calculate the display and printout layouts. The display layout is calculated in DocumentLayoutUnit.Pixel by default, which is best suited for a screen display. The print layout is calculated in DocumentLayoutUnit.Document.

Use the LayoutUnit property to adjust the documents’ look. Set the LayoutUnit to DocumentLayoutUnit.Pixel to improve text rendering and the overall display appearance. For a more accurate layout, specify DocumentLayoutUnit.Twip as the unit of measurement.

Important

With the RichEditControlCompatibility.EnableLegacyLayoutEngine property set to false, the LayoutUnit property doesn’t affect the document model layout calculation. Set the RichEditControlCompatibility.EnableLegacyLayoutEngine property set to true on application startup to manage the document layout manually. Refer to the How to: Perform Actions On Application Startup topic for details.

See Also