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.1.dll
NuGet Package: DevExpress.Data
Declaration
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 |
|
WebDocumentViewerSettingsBase |
|
|
.NET Reporting Tools | DxReportDesignerReportPreviewSettings |
|
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.
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.
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:
- ASPxReportsStringId.WebDocumentViewer_Print_Popup_Caption
- ASPxReportsStringId.WebDocumentViewer_Print_Popup_LinkText
- ASPxReportsStringId.WebDocumentViewer_Print_Popup_Text
UseSameTab = False
When a user clicks the Print toolbar icon, the Document Viewer opens a new browser tab to display the Print dialog.
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;
// ...
}