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.v18.2.Core.dll
Declaration
[Obsolete("The DashboardPrintPreviewOptions.ScaleMode property is obsolete now. Use the DocumentScaleMode and DashboardAutomaticPageLayout properties instead.")]
[Browsable(false)]
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. |
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 |
|
CustomExportBaseEventArgs |
|
CustomExportEventArgs |
|
CustomizeExportDocumentEventArgs |
|
DashboardDesigner |
|
DashboardViewer |
|
DashboardControl |
|
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. |