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 KB article: https://www.devexpress.com/Support/Center/Question/Details/T488406
Gets or sets the mode for scaling when printing a dashboard (dashboard item).
Namespace: DevExpress.DashboardWin
Assembly: DevExpress.Dashboard.v18.2.Win.dll
Declaration
[Obsolete("The DashboardPrintingOptions.ScaleMode property is obsolete now. Use the DashboardPrintPreviewOptions.ScaleMode and DashboardPdfExportOptions.ScaleMode properties instead. To learn more, see the following KB article: https://www.devexpress.com/Support/Center/Question/Details/T488406")]
[DefaultValue(DashboardPrintingScaleMode.AutoFitWithinOnePage)]
public DashboardPrintingScaleMode ScaleMode { get; set; }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. |