PrintPreviewOptions.ShowOptionsBeforeExport Property

Gets or sets a value which indicates whether an Export Options window should be shown when an end-user exports a document from the Print Preview.

Namespace: DevExpress.XtraPrinting

Assembly: DevExpress.Printing.v20.1.Core.dll

Declaration

[DefaultValue(true)]
public bool ShowOptionsBeforeExport { get; set; }
<DefaultValue(True)>
Public Property ShowOptionsBeforeExport As Boolean

Property Value

Type Default Description
Boolean

true

true to show the Export Options window; otherwise, false.

Property Paths

You can access this nested property as listed below:

Show 12 property paths
Library Object Type Path to ShowOptionsBeforeExport
Cross-Platform Class Library RemotePrintingSystem
.ExportOptions.PrintPreview.ShowOptionsBeforeExport
ExportOptions
.PrintPreview.ShowOptionsBeforeExport
PrintingSystemBase
.ExportOptions.PrintPreview.ShowOptionsBeforeExport
WinForms Controls PrintingSystem
.ExportOptions.PrintPreview.ShowOptionsBeforeExport
XtraSchedulerReport
.ExportOptions.PrintPreview.ShowOptionsBeforeExport
WPF Controls ExportOptionsContainer
.PrintPreview.ShowOptionsBeforeExport
PrintingSystem
.ExportOptions.PrintPreview.ShowOptionsBeforeExport
PrintingSystem
.ExportOptions.PrintPreview.ShowOptionsBeforeExport
Reporting XtraReport
.ExportOptions.PrintPreview.ShowOptionsBeforeExport
DocumentOperationRequest
.ExportOptions.PrintPreview.ShowOptionsBeforeExport
Silverlight Controls PrintingSystem
.ExportOptions.PrintPreview.ShowOptionsBeforeExport
PrintingSystem
.ExportOptions.PrintPreview.ShowOptionsBeforeExport

Remarks

Use the ShowOptionsBeforeExport property to specify whether the Export Options window should be shown for an end-user before a document is exported. For instance, you may manually specify all export options via the PrintingSystemBase.ExportOptions property, and set the ShowOptionsBeforeExport property to false, so that an end-user can't change export settings.

Examples

This example illustrates how to specify the primary export options of a report by using the XtraReport.ExportOptions property. These options are taken into account when a document is being exported from a print preview.

This example presumes that a report is exported silently, without prompting an end-user to customize the export options.

All available export options are listed in the ExportOptionKind enumeration.

using System;
using System.Drawing.Imaging;
using System.Globalization;
using System.Text;
using System.Windows.Forms;
using DevExpress.XtraPrinting;
// ...

namespace WindowsFormsApplication1 {
    public partial class Form1 : Form {
        public Form1() {
            InitializeComponent();
        }

        private XtraReport1 report;

        private void Form1_Load(object sender, EventArgs e) {
            report = new XtraReport1();
            documentViewer1.DocumentSource = report;
            report.CreateDocument();

            PrintingSystemBase printingSystem1 = report.PrintingSystem;

            // Obtain the current export options.
            ExportOptions options = printingSystem1.ExportOptions;

            // Set Print Preview options.
            options.PrintPreview.ActionAfterExport = ActionAfterExport.AskUser;
            options.PrintPreview.DefaultDirectory = "C:\\Temp";
            options.PrintPreview.DefaultFileName = "Report";
            options.PrintPreview.SaveMode = SaveMode.UsingDefaultPath;
            options.PrintPreview.ShowOptionsBeforeExport = false;

            // Set E-mail options.
            options.Email.RecipientAddress = "someone@somewhere.com";
            options.Email.RecipientName = "Someone";
            options.Email.Subject = "Test";
            options.Email.Body = "Test";

            // Set CSV-specific export options.
            options.Csv.Encoding = Encoding.Unicode;
            options.Csv.Separator =
                CultureInfo.CurrentCulture.TextInfo.ListSeparator.ToString();

            // Set HTML-specific export options.
            options.Html.CharacterSet = "UTF-8";
            options.Html.RemoveSecondarySymbols = false;
            options.Html.Title = "Test Title";

            // Set Image-specific export options.
            options.Image.Format = ImageFormat.Jpeg;

            // Set MHT-specific export options.
            options.Mht.CharacterSet = "UTF-8";
            options.Mht.RemoveSecondarySymbols = false;
            options.Mht.Title = "Test Title";

            // Set PDF-specific export options.
            options.Pdf.Compressed = true;
            options.Pdf.ImageQuality = PdfJpegImageQuality.Low;
            options.Pdf.NeverEmbeddedFonts = "Tahoma;Courier New";
            options.Pdf.DocumentOptions.Application = "Test Application";
            options.Pdf.DocumentOptions.Author = "Test Team";
            options.Pdf.DocumentOptions.Keywords = "Test1, Test2";
            options.Pdf.DocumentOptions.Subject = "Test Subject";
            options.Pdf.DocumentOptions.Title = "Test Title";

            // Set Text-specific export options.
            options.Text.Encoding = Encoding.Unicode;
            options.Text.Separator =
                CultureInfo.CurrentCulture.TextInfo.ListSeparator.ToString();

            // Set XLS-specific export options.
            options.Xls.ShowGridLines = true;
            options.Xls.SheetName = "Page 1";
            options.Xls.TextExportMode = TextExportMode.Value;

            // Set XLSX-specific export options.
            options.Xlsx.ShowGridLines = true;
            options.Xlsx.SheetName = "Page 1";
            options.Xlsx.TextExportMode = TextExportMode.Value;
        }
    }
}
See Also