Skip to main content
All docs
V24.2

ExportSettings.UseSameTab Property

Specifies whether to print and export documents in the browser tab that contains the Document Viewer.

Namespace: DevExpress.XtraReports.Web.WebDocumentViewer.DataContracts

Assembly: DevExpress.Data.v24.2.dll

NuGet Package: DevExpress.Data

#Declaration

[DataMember(Name = "useSameTab")]
public bool UseSameTab { get; set; }

#Property Value

Type Description
Boolean

true, to print and export documents in the tab that contains the Document Viewer; false to open another browser tab for print and export.

#Property Paths

You can access this nested property as listed below:

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

#Remarks

Use the UseSameTab property to specify whether to print and export documents in the same browser tab where the Document Viewer is placed, or in a separate tab.

#UseSameTab = True (Default)

When a user clicks the Print toolbar icon, the Print dialog appears in the tab that contains the Document Viewer.

The Print dialog

When a document is printed, the Document Viewer displays an additional dialog with a link to the PDF file that was sent to the printer.

An additional dialog

This 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 dialog with the following localization strings:

#UseSameTab = False

When a user clicks the Print toolbar icon, the Document Viewer opens a new browser tab to display the Print dialog.

The Print dialog in a new browser tab

#Code Examples

#ASP.NET Core

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

#Angular

 

report-viewer.html

<dx-report-viewer [reportUrl]="reportUrl" height="800px">
    <dxrv-request-options [invokeAction]="invokeAction" [host]="hostUrl"></dxrv-request-options>
    <dxrv-export-settings [useSameTab]="useSameTabExport"></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';
    useSameTabExport: boolean = false;
: boolean = true;
    // ...
}
See Also