DashboardExportOptions.ScaleMode Property

OBSOLETE

The DashboardExportOptions.ScaleMode property is obsolete now. Use the DashboardPdfExportOptions.ScaleMode property instead. To learn more, see the following breaking change: https://supportcenter.devexpress.com/ticket/details/t986338/

Gets or sets the mode for scaling when exporting a dashboard (dashboard item).

Namespace: DevExpress.DashboardWeb

Assembly: DevExpress.Dashboard.v24.1.Web.WebForms.dll

NuGet Package: DevExpress.Web.Dashboard

Declaration

C#

[DefaultValue(DashboardExportScaleMode.AutoFitWithinOnePage)]
[Obsolete("The DashboardExportOptions.ScaleMode property is obsolete now. Use the DashboardPdfExportOptions.ScaleMode property instead. To learn more, see the following breaking change: https://supportcenter.devexpress.com/ticket/details/t986338/")]
public DashboardExportScaleMode ScaleMode { get; set; }

VB.NET

<Obsolete("The DashboardExportOptions.ScaleMode property is obsolete now. Use the DashboardPdfExportOptions.ScaleMode property instead. To learn more, see the following breaking change: https://supportcenter.devexpress.com/ticket/details/t986338/")>
<DefaultValue(DashboardExportScaleMode.AutoFitWithinOnePage)>
Public Property ScaleMode As DashboardExportScaleMode

Property Value

Type	Default	Description
DashboardExportScaleMode	AutoFitWithinOnePage	A DashboardExportScaleMode enumeration value that specifies the mode for scaling when exporting a dashboard (dashboard item).

Available values:

Name	Description
None	The dashboard (dashboard item) on the exported page retains its original size.
UseScaleFactor	The size of the dashboard (dashboard item) on the exported page is changed according to the scale factor value.
AutoFitToPageWidth	The size of the dashboard (dashboard item) is changed according to the width of the exported page.
AutoFitWithinOnePage	The size of the dashboard (dashboard item) is changed to fit its content on a single page.

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	DashboardExportOptions.AutoFitPageCount	Splits the dashboard into multiple pages and aligns it.
DashboardExportScaleMode.UseScaleFactor	DashboardExportOptions.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.