DashboardPrintingOptions.ScaleMode Property

OBSOLETE

The DashboardPrintingOptions.ScaleMode property is obsolete now. Use the DashboardPrintPreviewOptions.ScaleMode and DashboardPdfExportOptions.ScaleMode properties instead. To learn more, see the following breaking change: https://supportcenter.devexpress.com/ticket/details/bc4046/

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

Namespace: DevExpress.DashboardWin

Assembly: DevExpress.Dashboard.v24.2.Win.dll

Declaration

C#

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

VB.NET

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

Property Value

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

Available values:

Name	Description
None	The dashboard (dashboard item) on the printed page retains its original size.
UseScaleFactor	The size of the dashboard (dashboard item) on the printed 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 printed 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 printing options depending on the selected mode.

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