All docs
V21.2
21.2 (EAP/Beta)
21.1
The page you are viewing does not exist in version 21.1. This link will take you to the root page.
20.2
The page you are viewing does not exist in version 20.2. This link will take you to the root page.
20.1
The page you are viewing does not exist in version 20.1. This link will take you to the root page.
19.2
The page you are viewing does not exist in version 19.2. This link will take you to the root page.
19.1
The page you are viewing does not exist in version 19.1. This link will take you to the root page.
18.2
The page you are viewing does not exist in version 18.2. This link will take you to the root page.
18.1
The page you are viewing does not exist in version 18.1. This link will take you to the root page.
17.2
The page you are viewing does not exist in version 17.2. This link will take you to the root page.
You are viewing help content for pre-release software. This document and the features it describes are subject to change.

DocumentViewerBase.UseDirectXPaint Property

Specifies whether the Document Viewer control uses the DirectX Hardware Acceleration.

Namespace: DevExpress.DocumentView.Controls

Assembly: DevExpress.Utils.v21.2.dll

Declaration

[DefaultValue(DefaultBoolean.Default)]
[DXCategory("Appearance")]
public virtual DefaultBoolean UseDirectXPaint { get; set; }

Property Value

Type Default Description
DefaultBoolean

Default

True, to enable the DirectX Hardware Acceleration for the Document Viewer control; otherwise, False. The Default value is equivalent to False.

Available values:

Name Description
True

Corresponds to a Boolean value of true.

False

Corresponds to a Boolean value of false.

Default

The default behavior determined by the control’s logic.

Remarks

The GDI+ library is the default rendering engine for the Document Viewer control. If a viewer displays a document that contains many pages, this engine might render this document slowly. You can switch to the DirectX rendering engine to boost rendering performance. For this, enable the viewer’s UseDirectXPaint property. You can set the viewer’s EnableSmoothScrolling property to True to allow for more smooth page scrolling in DirectX mode. Note that smooth scrolling might require more application resources to render the pages.

The following limitations apply to the viewer when it uses DirectX rendering:

  • The Cached Report Source component is not supported.
  • The XRRichText control is rendered as an image. The default GDI+ library is used to render this control.
  • String sizes in a document might be greater compared with the case when the GDI+ library is used to render the document.
See Also