DashboardPrintPreviewOptions.ScaleMode Property

OBSOLETE

The DashboardPrintPreviewOptions.ScaleMode property is obsolete now. Use the DocumentScaleMode and DashboardAutomaticPageLayout properties instead.

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

Namespace: DevExpress.DashboardCommon

Assembly: DevExpress.Dashboard.v19.2.Core.dll

Declaration

C#

[Obsolete("The DashboardPrintPreviewOptions.ScaleMode property is obsolete now. Use the DocumentScaleMode and DashboardAutomaticPageLayout properties instead.")]
[Browsable(false)]
public DashboardExportScaleMode ScaleMode { get; set; }

VB.NET

<Obsolete("The DashboardPrintPreviewOptions.ScaleMode property is obsolete now. Use the DocumentScaleMode and DashboardAutomaticPageLayout properties instead.")>
<Browsable(False)>
Public Property ScaleMode As DashboardExportScaleMode

Property Value

Type	Description
DashboardExportScaleMode	A DashboardExportScaleMode enumeration value that specifies the mode for scaling a dashboard/dashboard item in the printed document.

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.

Property Paths

You can access this nested property as listed below:

Object Type	Path to ScaleMode
BeforeExportDocumentEventArgs	.PrintPreviewOptions.ScaleMode
CustomExportBaseEventArgs	.PrintPreviewOptions.ScaleMode
CustomExportEventArgs	.PrintPreviewOptions.ScaleMode
CustomizeExportDocumentEventArgs	.PrintPreviewOptions.ScaleMode
DashboardDesigner	.PrintPreviewOptions.ScaleMode
DashboardViewer	.PrintPreviewOptions.ScaleMode
DashboardControl	.PrintPreviewOptions.ScaleMode

Remarks

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

Scale Mode	Related Property	Description
DashboardExportScaleMode.AutoFitToPageWidth	DashboardPrintPreviewOptions.AutoFitPageCount	Splits the dashboard into multiple pages, and aligns it.
DashboardExportScaleMode.UseScaleFactor	DashboardPrintPreviewOptions.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.