Printing and Exporting for the Gauges in the WinForms Designer

• Apr 11, 2023
• 4 minutes to read

The BI Dashboard allows you to print/export individual dashboard items, or the entire dashboard. To learn more about printing concepts common to all dashboard items, see the Printing and Exporting topic.

This topic describes the specifics of printing/exporting a Gauge dashboard item.

Printing

If you are printing a Gauge dashboard item using the Print Preview, you can customize the following options (via the Options button) before printing.

• Show Title - Specifies whether to apply the dashboard item caption to the printed document title.
• Title - Specifies the title of the printed document.
• Auto Arrange Content - Specifies whether gauges are automatically arranged on the printed document.
• Include | Filters - Allows you to include master filter values to the printed document.
• Include | Parameters - Allows you to include parameter values to the printed document.
• Position - Specifies the position of the master filter and parameter values in the printed document. You can select between Below and Separate Page.

Specify the required options in the Options dialog and click the Submit button to apply the changes. To reset changes to the default values, click the Reset button.

Export to PDF

The following options are available when exporting the Gauge dashboard item to a PDF.

• Page Layout - Specifies the page orientation used to export a dashboard item.
• Size - Specifies the standard paper size.
• Show Title - Specifies whether to apply the Gauge caption to the exported document title.
• Title - Specifies the title of the exported document.
• Auto Arrange Content - Specifies whether gauges are automatically arranged in the exported document.
• Scale Mode - Specifies the mode for scaling when exporting a dashboard item.
• Scale Factor - Specifies the scale factor (in fractions of 1) by which a dashboard item is scaled.
• Auto Fit Page Count - Specifies the number of horizontal/vertical pages that span the total width/height of a dashboard item.
• Include | Filters - Allows you to include master filter values to the exported document.
• Include | Parameters - Allows you to include parameter values to the exported document.
• Position - Specifies the position of the master filter and parameter values in the exported document. You can select between Below and Separate Page.

Specify the required options in this dialog and click Export to export the Gauge dashboard item. To reset changes to the default values, click the Reset button.

Export to Image

All data-bound dashboard items provide the same set of options when exporting them to an Image format. The following options are available:

• Image Format - Specifies the image format in which the dashboard item is exported.
• Show Title - Specifies whether to apply the dashboard item caption to the exported document title.
• Title - Specifies the title of the exported document.
• Resolution (dpi) - Specifies the resolution (in dpi) used to export the dashboard item.
• Include | Filters - Allows you to include master filter values to the exported document.
• Include | Parameters - Allows you to include parameter values to the exported document.

Specify the required options in this dialog and click Export to export the dashboard item. To reset changes to the default values, click the Reset button.

Export to Excel

Data visualized within all data-bound dashboard items can be exported to the specified Excel format. The following options are available:

• Excel Format - Specifies the Excel format in which the dashboard item is exported. You can use the XLSX, XLS or CSV formats.
• Separator - Specifies the string used to separate values in the exported CSV document.
• Include | Filters - Allows you to include master filter values to the exported document.
• Include | Parameters - Allows you to include parameter values to the exported document.
• Position - Specifies the position of the master filter and parameter values in the exported document. You can select between Below and Separate Sheet.

Specify the required options in this dialog and click Export to export the dashboard item. To reset changes to the default values, click the Reset button.

Custom Export

The Dashboard control rises the CustomExport event before saving the exported document to the PDF and Image formats. Use this event to obtain the printable XRGaugeDashboardItem control for GaugeDashboardItem and customize the exported document.

Refer to the Custom Export section for details.