GrapeCity.ActiveReports.PrinterSettings.UsePrintingThread

UsePrintingThread Property

UsePrintingThread

Gets or sets a value indicating whether the printing process should be executed on a separate thread.

Declaration

public bool UsePrintingThread { get; set; }

Property Value

Type	Description
bool	`true` if the printing process should be executed on a separate thread; otherwise, `false`. The default value is `true`.

Remarks

Utilizing a separate thread for the printing process can enhance the responsiveness of the user interface during long-running print jobs. When set to true, this property enables asynchronous printing, allowing the main application thread to remain responsive to user actions while the printing operation is executed in the background. Setting this property to false causes the printing process to run synchronously on the main application thread. This may be necessary in certain scenarios where printing operations need to be closely synchronized with other UI operations or when using printing components that do not support multithreaded execution. It is recommended to test the printing functionality in your specific application context to determine the most appropriate setting for this property.

Examples

This example demonstrates how to disable the use of a separate printing thread for synchronous printing:

var printerSettings = new GrapeCity.ActiveReports.PrinterSettings();
printerSettings.UsePrintingThread = false;
// Proceed with printing operations