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 ASPx
API reduces flexibility when you configure the control. The DashboardASPx
object. The control provides access to all client settings and allows you to implement complex scenarios. We recommend that you use the Dashboard
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 Chart |
#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 Dashboard |
#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 Dashboard |
#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 |
---|---|---|
Dashboard |
Dashboard |
Splits the dashboard into multiple pages and aligns it. |
Dashboard |
Dashboard |
Scales the dashboard. |
Dashboard |
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.
#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.
#FontInfo Property
Provides access to the font settings of the exported document.
#Declaration
FontInfo: ExportFontInfo
#Property Value
Type | Description |
---|---|
Export |
A Export |
#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 Map |
#PageLayout Property
Gets or sets the page orientation used to export a dashboard/dashboard item.
#Declaration
PageLayout: string
#Property Value
Type | Description |
---|---|
string | A Dashboard |
#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 Dashboard |
#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 Range |
#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 Dashboard |
#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 |
---|---|---|
Dashboard |
Dashboard |
Splits the dashboard into multiple pages and aligns it. |
Dashboard |
Dashboard |
Scales the dashboard. |
Dashboard |
n/a | Changes the dashboard size to fit its content on a single page. |
Dashboard |
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. |
#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. |
#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 Treemap |