Back to Devexpress

dxEnableMultiThreading Constant

vcl-dxthreading-f2ac8053.md

latest2.5 KB
Original Source

dxEnableMultiThreading Constant

Specifies if multithreading is enabled in all DevExpress controls used in an application.

Declaration

delphi
const dxEnableMultiThreading: Boolean = True;

Returns

TypeDescription
BooleanTrue Recommended. DevExpress controls can use multi-threaded calculations.FalseDevExpress controls cannot use multi-threaded calculations; all corresponding settings have no effect.

Remarks

All DevExpress controls that benefit from multithreading call the dxCanUseMultiThreading global function to identify if they can use multithreaded data processing algorithms and run any other routines in separate threads. If the dxEnableMultiThreading global constant value is False, the dxCanUseMultiThreading function returns False without checking all other multithreading availability conditions.

Affected Control Settings

You can use the following properties to explicitly enable or disable multi-threaded calculations for individual DevExpress controls if the dxEnableMultiThreading global constant is set to True ( default ):

TdxPDFViewerOptionsBehavior.RenderContentInBackgroundSpecifies if the PDF Viewer control repaints document pages in a separate thread rather than the main thread.TcxCustomDataController.MultiThreadedOptionsProvides access to multi-threading settings.TcxTreeListOptionsData.MultiThreadedSortingSpecifies if the tree list control uses a multi-threaded sorting algorithm.TcxvgMultiRecordsOptionsData.MultiThreadedFilteringSpecifies if the vertical grid control uses a multi-threaded filtering algorithm.

Important

We recommend that you leave multi-threaded algorithms enabled to ensure the best application performance. You may need to disable multi-threaded calculations in a component only if you implement a thread-unsafe version of the corresponding algorithm.

See Also

dxCanUseMultiThreading Global Function

dxThreading Unit