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.v21.2.Core.dll

Declaration

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

Property Value

Type Description
DashboardExportScaleMode

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

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
IDashboardControl
.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.
See Also