Skip to main content
BuyLog In
Business Intelligence Dashboard
Search in…
Docs > ASP.NET Client API Reference > DashboardPdfExportOptions
All docs
V24.1
Business Intelligence Dashboard
Get Started
.NET Support
Basic Concepts and Terminology
Common Features
WinForms Dashboard
Web Dashboard
WPF Dashboard Viewer
Visual Studio Integration
Redistribution and Deployment
Video Tutorials
Migration Guides
Examples
End-User Documentation
.NET Framework API Reference
.NET API Reference
HTML JS Control API Reference
ASP.NET Client API Reference
ASPxClientActionAvailabilityChangedEventArgs
ASPxClientCustomizeDataSourceWizardEventArgs
ASPxClientDashboard
ASPxClientDashboardBeginUpdateEventArgs
ASPxClientDashboardChangedEventArgs
ASPxClientDashboardEndUpdateEventArgs
ASPxClientDashboardExportOptions
ASPxClientDashboardInitializedEventArgs
ASPxClientDashboardInitializingEventArgs
ASPxClientDashboardItemCaptionToolbarUpdatedEventArgs
ASPxClientDashboardItemClickEventArgs
ASPxClientDashboardItemData
ASPxClientDashboardItemDataAxis
ASPxClientDashboardItemDataAxisPoint
ASPxClientDashboardItemDataAxisPointTuple
ASPxClientDashboardItemDataDelta
ASPxClientDashboardItemDataDeltaValue
ASPxClientDashboardItemDataDimension
ASPxClientDashboardItemDataDimensionValue
ASPxClientDashboardItemDataMeasure
ASPxClientDashboardItemDataMeasureValue
ASPxClientDashboardItemDrillDownStateChangedEventArgs
ASPxClientDashboardItemElementCustomColorEventArgs
ASPxClientDashboardItemEventArgs
ASPxClientDashboardItemMasterFilterStateChangedEventArgs
ASPxClientDashboardItemRequestUnderlyingDataParameters
ASPxClientDashboardItemSelectionChangedEventArgs
ASPxClientDashboardItemUnderlyingData
ASPxClientDashboardItemVisualInteractivityEventArgs
ASPxClientDashboardItemWidgetEventArgs
ASPxClientDashboardParameter
ASPxClientDashboardParameterValue
ASPxClientDashboardParameters
ASPxClientDashboardRangeFilterSelection
ASPxClientDashboardStateChangedEventArgs
ASPxClientDashboardTitleToolbarUpdatedEventArgs
ASPxClientDynamicLookUpValuesLoadedEventArgs
ASPxClientItemBeginUpdateEventArgs
ASPxClientItemEndUpdateEventArgs
ASPxClientSelectedTabPageChangedEventArgs
CardExportOptions
ChartExportOptions
ChartExportSizeMode
DashboardDataAxisNames
DashboardExcelExportOptions
DashboardExportDocumentScaleMode
DashboardExportExcelFormat
DashboardExportFilterState
DashboardExportImageFormat
DashboardExportPageLayout
DashboardExportPaperKind
DashboardExportScaleMode
DashboardImageExportOptions
DashboardPdfExportOptions
AutoFitPageCount
CardAutoArrangeContent
ChartAutomaticPageLayout
ChartSizeMode
DashboardAutomaticPageLayout
DashboardStatePosition
DocumentScaleMode
ExportFilters
ExportParameters
FontInfo
GaugeAutoArrangeContent
GridFitToPageWidth
GridPrintHeadersOnEveryPage
IncludeHiddenParameters
MapAutomaticPageLayout
MapSizeMode
PageLayout
PaperKind
PieAutoArrangeContent
PivotPrintHeadersOnEveryPage
RangeFilterAutomaticPageLayout
RangeFilterSizeMode
ScaleFactor
ScaleMode
ShowTitle
Title
TreemapAutomaticPageLayout
TreemapSizeMode
DashboardSelectionMode
DashboardSpecialValues
DashboardStateExcelExportPosition
DashboardStateExportPosition
ExcelExportFilterState
ExcelFormatOptions
ExportFontInfo
GaugeExportOptions
GridExportOptions
ImageFormatOptions
MapExportOptions
MapExportSizeMode
PieExportOptions
PivotExportOptions
RangeFilterExportOptions
RangeFilterExportSizeMode
TreemapExportOptions
TreemapExportSizeMode
ASPxClientActionAvailabilityChangedEventHandler<Sender>
ASPxClientCustomizeDataSourceWizardEventHandler<Sender>
ASPxClientDashboardBeforeRenderEventHandler<Sender>
ASPxClientDashboardBeginUpdateEventHandler<Sender>
ASPxClientDashboardChangedEventHandler<Sender>
ASPxClientDashboardEndUpdateEventHandler<Sender>
ASPxClientDashboardInitializedEventHandler<Sender>
ASPxClientDashboardInitializingEventHandler<Sender>
ASPxClientDashboardItemBeforeWidgetDisposedEventHandler<Sender>
ASPxClientDashboardItemCaptionToolbarUpdatedEventHandler<Sender>
ASPxClientDashboardItemClickEventHandler<Sender>
ASPxClientDashboardItemDrillDownStateChangedEventHandler<Sender>
ASPxClientDashboardItemElementCustomColorEventHandler<Sender>
ASPxClientDashboardItemMasterFilterStateChangedEventHandler<Sender>
ASPxClientDashboardItemRequestUnderlyingDataCompleted
ASPxClientDashboardItemSelectionChangedEventHandler<Sender>
ASPxClientDashboardItemVisualInteractivityEventHandler<Sender>
ASPxClientDashboardItemWidgetCreatedEventHandler<Sender>
ASPxClientDashboardItemWidgetUpdatedEventHandler<Sender>
ASPxClientDashboardItemWidgetUpdatingEventHandler<Sender>
ASPxClientDashboardStateChangedEventHandler<Sender>
ASPxClientDashboardTitleToolbarUpdatedEventHandler<Sender>
ASPxClientDynamicLookUpValuesLoadedEventHandler<Sender>
ASPxClientItemBeginUpdateEventHandler<Sender>
ASPxClientItemEndUpdateEventHandler<Sender>
ASPxClientSelectedTabPageChangedEventHandler<Sender>
Download CHM

DashboardPdfExportOptions Class

Contains options related to exporting a dashboard/dashboard item to PDF format.

Declaration

declare class DashboardPdfExportOptions

Remarks

The ASPxClientDashboard.GetPdfExportOptions and ASPxClientDashboard.SetPdfExportOptions properties allow you to obtain and specify PDF-specific export options on the client side.

You can use the ASPxClientDashboard.ExportToPdf and ASPxClientDashboard.ExportDashboardItemToPdf methods to specify PDF options when exporting a dashboard/dashboard item using the following methods.

Warning

A use of ASPxClientDashboard API reduces flexibility when you configure the control. The DashboardControl underlies the ASPxClientDashboard object. The control provides access to all client settings and allows you to implement complex scenarios. We recommend that you use the DashboardControl API to configure the Web Dashboard on the client. More information: Client-Side Functionality.

Properties

AutoFitPageCount Property

Gets or sets the number of horizontal/vertical pages that span the total width/height of a dashboard/dashboard item.

Declaration

AutoFitPageCount: number

Property Value

Type Description
number

An integer value that specifies the number of horizontal/vertical pages that span the total width/height of a dashboard/dashboard item.

Remarks

The AutoFitPageCount property is in effect when the DashboardPdfExportOptions.ScaleMode property is set to DashboardExportScaleMode.AutoFitToPageWidth.

CardAutoArrangeContent Property

Gets or sets whether cards within the Card dashboard item are automatically arranged on the exported page.

Declaration

CardAutoArrangeContent: boolean

Property Value

Type Description
boolean

true, to automatically arrange cards on the exported page; otherwise, false.

ChartAutomaticPageLayout Property

Gets or sets whether the page orientation used to export the Chart dashboard item is selected automatically.

Declaration

ChartAutomaticPageLayout: boolean

Property Value

Type Description
boolean

true, to automatically select the page orientation used to export the Chart dashboard item; otherwise, false.

Remarks

If the ChartAutomaticPageLayout property is set to true, it overrides the page orientation specified using the DashboardPdfExportOptions.PageLayout property.

ChartSizeMode Property

Gets or sets the export size mode for the Chart dashboard item.

Declaration

ChartSizeMode: string

Property Value

Type Description
string

A ChartExportSizeMode value that specifies the export size mode for the Chart dashboard item.

DashboardAutomaticPageLayout Property

Gets or sets whether the page orientation used to export a dashboard is selected automatically.

Declaration

DashboardAutomaticPageLayout: boolean

Property Value

Type Description
boolean

true, to automatically select the page orientation used to export a dashboard; otherwise, false.

DashboardStatePosition Property

Gets or sets a position of the dashboard state (such as master filter or current parameter values) in the exported document.

Declaration

DashboardStatePosition: string

Property Value

Type Description
string

A DashboardStateExportPosition object that specifies the position of the dashboard state in the exported document.

Remarks

To add a master state to the exported document, use the DashboardPdfExportOptions.ExportFilters property. To export current parameter values, enable the DashboardPdfExportOptions.ExportParameters flag.

DocumentScaleMode Property

Gets or sets the mode for scaling a dashboard/dashboard item in the exported document.

Declaration

DocumentScaleMode: string

Property Value

Type Description
string

A DashboardExportDocumentScaleMode value that specifies the mode for scaling a dashboard/dashboard item in the exported document.

Remarks

To change the size of the dashboard or split it into several pages, use the DocumentScaleMode property and specify the following export options depending on the selected mode:

Scale Mode Related Property Description
DashboardExportDocumentScaleMode.AutoFitToPagesWidth DashboardPdfExportOptions.AutoFitPageCount Splits the dashboard into multiple pages and aligns it.
DashboardExportDocumentScaleMode.UseScaleFactor DashboardPdfExportOptions.ScaleFactor Scales the dashboard.
DashboardExportDocumentScaleMode.None n/a The dashboard size is fixed, and other dashboard scaling settings are not in effect.

ExportFilters Property

Gets or sets whether to add the state of master filter items to the exported document.

Declaration

ExportFilters: boolean

Property Value

Type Description
boolean

true, to add the state of master filter items to the exported document; otherwise, false.

Remarks

To specify a position of the dashboard state (that includes the state of master filter items), use the DashboardPdfExportOptions.DashboardStatePosition property.

See Also

ExportParameters Property

Gets or sets whether to add current parameter values to the exported document.

Declaration

ExportParameters: boolean

Property Value

Type Description
boolean

true, to add current parameter values to the exported document; otherwise, false.

Remarks

To specify the position of the dashboard state (including current parameter values), use the DashboardPdfExportOptions.DashboardStatePosition property.

See Also

FontInfo Property

Provides access to the font settings of the exported document.

Declaration

FontInfo: ExportFontInfo

Property Value

Type Description
ExportFontInfo

A ExportFontInfo object containing the font settings of the exported document.

GaugeAutoArrangeContent Property

Gets or sets whether gauges within the Gauge dashboard item are automatically arranged on the exported page.

Declaration

GaugeAutoArrangeContent: boolean

Property Value

Type Description
boolean

true, to arrange gauges automatically on the exported page; otherwise, false.

GridFitToPageWidth Property

Gets or sets whether the size of the Grid dashboard item is changed according to the width of the exported page.

Declaration

GridFitToPageWidth: boolean

Property Value

Type Description
boolean

true, to change the size of the Grid dashboard item according to the width of the exported page; otherwise, false.

GridPrintHeadersOnEveryPage Property

Gets or sets whether to add column headers of the Grid dashboard item to every page.

Declaration

GridPrintHeadersOnEveryPage: boolean

Property Value

Type Description
boolean

true, to add column headers to every page; otherwise, false.

IncludeHiddenParameters Property

Gets or sets whether to add current values of a hidden parameter to the exported document.

Declaration

IncludeHiddenParameters: boolean

Property Value

Type Description
boolean

true, to add current values of a hidden parameter to the exported document; otherwise, false.

Remarks

Note that the IncludeHiddenParameters property requires enabling the DashboardPdfExportOptions.ExportParameters property.

MapAutomaticPageLayout Property

Gets or sets whether the page orientation used to export the Map dashboard item is selected automatically.

Declaration

MapAutomaticPageLayout: boolean

Property Value

Type Description
boolean

true, to automatically select the page orientation used to export the Map dashboard item; otherwise, false.

MapSizeMode Property

Gets or sets the export size mode for the Map dashboard item.

Declaration

MapSizeMode: string

Property Value

Type Description
string

A MapExportSizeMode value that specifies the export size mode for the Map dashboard item.

PageLayout Property

Gets or sets the page orientation used to export a dashboard/dashboard item.

Declaration

PageLayout: string

Property Value

Type Description
string

A DashboardExportPageLayout value that specifies the page orientation used to export a dashboard/dashboard item.

Remarks

Note that specific dashboard items allow you to specify the page orientation as well. For instance, for the Chart dashboard item, you can specify the DashboardPdfExportOptions.ChartAutomaticPageLayout property that can override the value specified using PageLayout.

PaperKind Property

Gets or sets the type of paper for the exported document.

Declaration

PaperKind: string

Property Value

Type Description
string

A DashboardExportPaperKind value that specifies the type of paper for the exported document.

PieAutoArrangeContent Property

Gets or sets whether pies within the Pie dashboard item are automatically arranged on the exported page.

Declaration

PieAutoArrangeContent: boolean

Property Value

Type Description
boolean

true, to arrange pies automatically on the exported page; otherwise, false.

PivotPrintHeadersOnEveryPage Property

Gets or sets whether to add column headers of the Pivot dashboard item to every page.

Declaration

PivotPrintHeadersOnEveryPage: boolean

Property Value

Type Description
boolean

true, to add column headers to every page; otherwise, false.

RangeFilterAutomaticPageLayout Property

Gets or sets whether the page orientation used to export the Range Filter dashboard item is selected automatically.

Declaration

RangeFilterAutomaticPageLayout: boolean

Property Value

Type Description
boolean

true, to automatically select the page orientation used to export the Range Filter dashboard item; otherwise, false.

Remarks

If the RangeFilterAutomaticPageLayout property is set to true, it overrides the page orientation specified using the DashboardPdfExportOptions.PageLayout property.

RangeFilterSizeMode Property

Gets or sets the export size mode for the Range Filter dashboard item.

Declaration

RangeFilterSizeMode: string

Property Value

Type Description
string

A RangeFilterExportSizeMode value that specifies the export size mode for the Range Filter dashboard item.

ScaleFactor Property

Gets or sets the scale factor (in fractions of 1), by which a dashboard/dashboard item is scaled in the exported document.

Declaration

ScaleFactor: number

Property Value

Type Description
number

A Single value that specifies the scale factor by which a dashboard/dashboard item is scaled in the exported document.

Remarks

The ScaleFactor property is in effect when the DashboardPdfExportOptions.DocumentScaleMode property is set to DashboardExportDocumentScaleMode.UseScaleFactor.

ScaleMode Property

Obsolete. Gets or sets the mode for scaling a dashboard/dashboard item in the exported document.

Declaration

ScaleMode: string

Property Value

Type Description
string

A DashboardExportScaleMode value that specifies the mode for scaling a dashboard/dashboard item in the exported document.

Remarks

To change the size of the dashboard or split it into several pages, specify the ScaleMode property. Then specify the following export options depending on the selected mode.

Scale Mode Related Property Description
DashboardExportScaleMode.AutoFitToPageWidth DashboardPdfExportOptions.AutoFitPageCount Splits the dashboard into multiple pages and aligns it.
DashboardExportScaleMode.UseScaleFactor DashboardPdfExportOptions.ScaleFactor Scales the dashboard.
DashboardExportScaleMode.AutoFitWithinOnePage n/a Changes the dashboard size to fit its content on a single page.
DashboardExportScaleMode.None n/a The dashboard size is fixed, and other dashboard scaling settings are not in effect.

ShowTitle Property

Gets or sets whether a dashboard title (or dashboard item’s caption) is included as the exported document title.

Declaration

ShowTitle: boolean

Property Value

Type Description
boolean

A boolean value that specifies whether a dashboard title (or dashboard item’s caption) is included as the exported document title.
See Also

Title Property

Gets or sets the title of the exported document.

Declaration

Title: string

Property Value

Type Description
string

A string value that specifies the title of the exported document.
See Also

TreemapAutomaticPageLayout Property

Gets or sets whether the page orientation used to export the Treemap dashboard item is selected automatically.

Declaration

TreemapAutomaticPageLayout: boolean

Property Value

Type Description
boolean

true, to automatically select the page orientation used to export the Treemap dashboard item; otherwise, false.

Remarks

If the TreemapAutomaticPageLayout property is set to true, it overrides the page orientation specified using the DashboardPdfExportOptions.PageLayout property.

TreemapSizeMode Property

Gets or sets the export size mode for the Treemap dashboard item.

Declaration

TreemapSizeMode: string

Property Value

Type Description
string

A TreemapExportSizeMode value that specifies the export size mode for the Treemap dashboard item.