DashboardPrintPreviewOptions.DocumentScaleMode Property
Gets or sets the mode for scaling a dashboard/dashboard item in the printed document.
Namespace: DevExpress.DashboardCommon
Assembly: DevExpress.Dashboard.v25.1.Core.dll
NuGet Package: DevExpress.Dashboard.Core
Declaration
[DefaultValue(DashboardExportDocumentScaleMode.None)]
public DashboardExportDocumentScaleMode DocumentScaleMode { get; set; }Property Value
| Type | Default | Description |
|---|---|---|
| DashboardExportDocumentScaleMode | None | A DashboardExportDocumentScaleMode 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. |
| AutoFitToPagesWidth | The size of the dashboard / dashboard item is changed according to the width of the exported pages. |
Property Paths
You can access this nested property as listed below:
| Object Type | Path to DocumentScaleMode |
|---|---|
| BeforeExportDocumentEventArgs |
|
| CustomExportBaseEventArgs |
|
| DashboardDesigner |
|
| DashboardViewer |
|
| IDashboardControl |
|
| DashboardControl |
|
Remarks
To change the size of the dashboard or split it into several pages, specify the DocumentScaleMode property. Then specify the following printing options depending on the selected mode.
| Scale Mode | Related Property | Description |
|---|---|---|
| DashboardExportDocumentScaleMode.AutoFitToPagesWidth | DashboardPrintPreviewOptions.AutoFitPageCount | Splits the dashboard into multiple pages and aligns it. |
| DashboardExportDocumentScaleMode.UseScaleFactor | DashboardPrintPreviewOptions.ScaleFactor | Scales the dashboard. |
| DashboardExportDocumentScaleMode.None | n/a | The dashboard size is fixed, and other dashboard scaling settings are not in effect. |