Manage the Print Progress

• Aug 18, 2023
• 2 minutes to read

Handle the following events to track the printing progress and change the printing settings at runtime:

• XtraReport.PrintProgress

  This event occurs before document pages are sent to a printer. You can obtain information about the current printing progress and access the current page index and other page settings in the event handler.

  Handle this event to perform any specific operations before printing each page, for instance, reflect the current printing state using the ProgressBarEdit control. You can also use the PrintProgressEventArgs.PageSettings property to change a printed page’s settings as shown below.

  C#

  using DevExpress.XtraPrinting;
  using DevExpress.Xpf.Printing;
  // ...
  
  private void simpleButton_Click(object sender, RoutedEventArgs e) {
      XtraReport1 report = new XtraReport1();
      report.PrintProgress += Report_PrintProgress;
      PrintHelper.Print(report);
  }
  
  private void Report_PrintProgress(object sender, PrintProgressEventArgs e) {
      if (e.PageIndex == 1) 
          e.PageSettings.Landscape = true;
  }
  

  VB.NET

  Imports DevExpress.XtraPrinting
  Imports DevExpress.Xpf.Printing
  ' ...
  
  Private Sub simpleButton_Click(ByVal sender As Object, ByVal e As RoutedEventArgs)
      Dim report As XtraReport1 = New XtraReport1()
      report.PrintProgress += Report_PrintProgress
      PrintHelper.Print(report)
  End Sub
  
  Private Sub Report_PrintProgress(ByVal sender As Object, ByVal e As PrintProgressEventArgs)
      If e.PageIndex = 1 
          Then e.PageSettings.Landscape = True
  End Sub
  

• PrintingSystemBase.StartPrint

  This event occurs only once - after one of the following actions (before sending a document to a printer):

  • calling the PrintHelper.PrintDirect method;
  • clicking the Quick Print button in the Document Preview.
  • clicking OK in the Print dialog (called either using the PrintHelper.Print method or the Print command in the Document Preview).

  The following tutorials demonstrate how to use this event to perform different tasks:

  • Specify the Number of Copies to Print
  • Print a Document Range
  • Specify the Paper Source and Printer Resolution
  • Share Printer Settings Between Reports