ExportSettings.ShowPrintNotificationDialog Property

Specifies whether to display an additional dialog that allows users to download the PDF file sent to printing.

Namespace: DevExpress.XtraReports.Web.WebDocumentViewer.DataContracts

Assembly: DevExpress.Data.v24.1.dll

NuGet Package: DevExpress.Data

Declaration

C#

[DataMember(Name = "showPrintNotificationDialog")]
public bool ShowPrintNotificationDialog { get; set; }

VB.NET

<DataMember(Name:="showPrintNotificationDialog")>
Public Property ShowPrintNotificationDialog As Boolean

Property Value

Type	Description
Boolean	true, to display an additional dialog; otherwise, false.

Property Paths

You can access this nested property as listed below:

Library	Object Type	Path to ShowPrintNotificationDialog
Cross-Platform Class Library	ReportPreviewSettings	.ExportSettings .ShowPrintNotificationDialog
	WebDocumentViewerSettingsBase	.ExportSettings .ShowPrintNotificationDialog
.NET Reporting Tools	DxReportDesignerReportPreviewSettings	.ExportSettings .ShowPrintNotificationDialog

Remarks

The ShowPrintNotificationDialog property is in effect when the UseSameTab property is enabled (the Document Viewer prints documents within the browser tab where it is placed). Use the ShowPrintNotificationDialog property to specify whether to display an additional dialog with a link to the printed PDF file:

• When users click the Print toolbar icon, the Print dialog appears where they can send a document to the printer.

  

• If the ShowPrintNotificationDialog property is enabled, the Document Viewer displays an additional dialog with a link to the PDF file that was just sent to the printer.

  

  This additional dialog helps users troubleshoot issues when the browser is unable to print a document. Disable the ShowPrintNotificationDialog property to hide this dialog. However, we recommend that your application should allow users to enable the ShowPrintNotificationDialog property or keep it enabled for cases when a browser stops printing documents after an update.

  You can localize the additional dialog with the following localization strings:

  • ASPxReportsStringId.WebDocumentViewer_Print_Popup_Caption
  • ASPxReportsStringId.WebDocumentViewer_Print_Popup_LinkText
  • ASPxReportsStringId.WebDocumentViewer_Print_Popup_Text

Code Examples

ASP.NET Core

Viewer

@{
    var viewerRender = Html.DevExpress().WebDocumentViewer("DocumentViewer")
        .Height("1000px")
        .ExportSettings(settings =>
        {
            settings.ShowPrintNotificationDialog = false;
        })
        .Bind("TestReport");
    @viewerRender.RenderHtml()
}

Designer

@{ var designerRender = Html.DevExpress().ReportDesigner("reportDesigner")
                     .Height("1000px")
                     .ReportPreviewSettings(previewsettings =>
                     {
                         previewsettings.ExportSettings.ShowPrintNotificationDialog = false;
                     })
                     .Bind("TestReport");
    @designerRender.RenderHtml() 
}

Angular

Viewer

 

report-viewer.html

<dx-report-viewer [reportUrl]="reportUrl" height="800px">
    <dxrv-request-options [invokeAction]="invokeAction" [host]="hostUrl"></dxrv-request-options>
        <dxrv-export-settings [useSameTab]="useSameTab" [showPrintNotificationDialog]="showPrintNotificationDialog"></dxrv-export-settings>
</dx-report-viewer>>

 

report-viewer.ts

import { Component, Inject, OnInit, ViewEncapsulation } from '@angular/core';

@Component({
  selector: 'report-viewer',
    encapsulation: ViewEncapsulation.None,
    templateUrl: './report-viewer.html',
  styleUrls: [
    //...
  ]
})
export class ReportViewerComponent {
    reportUrl: string = "TestReport";
    invokeAction: string = '/DXXRDV';
    useSameTab: boolean = true;
    showPrintNotificationDialog: boolean = false;
    // ...
}