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

TdxPDFViewerOptionsBehavior.RenderContentInBackground Property

Specifies if the PDF Viewer control repaints document pages in a separate thread rather than the main thread.

#Declaration

Delphi
property RenderContentInBackground: Boolean read; write; default False;

#Property Value

Type Default
Boolean False

#Remarks

Rendering multiple simultaneously visible pages (that is, when the control displays a large zoomed out document) in the main application thread can lock end-user interaction for a noticeable time. In background (that is, asynchronous) page rendering mode, the PDF Viewer control repaints the changed document view in a separate thread improving the overall end-user experience when working with especially large documents. In this mode, the control delays updating the document view for a specific time after its actual rotation, scrolling, or zooming to avoid excessive repaint operations.

Set the RenderContentInBackground property to True or False to enable or disable the asynchronous page rendering mode, respectively. Additionally, you can adjust the delay between the latest change made to the document view and its actual repainting by using the RenderContentDelay property.

Note

The RenderContentInBackground property value is ignored if the dxCanUseMultiThreading global function returns False.

The default RenderContentInBackground property value is False.

See Also