User Tools

Site Tools


api:dk11:delphi:fmx.giscontrolprintpreview.tgis_controlprintpreviewform.preview_tgis_printmanagerabstract_string_double

Table of Contents



TGIS_ControlPrintPreviewForm.Preview method

DK for Delphi | FMX.GisControlPrintPreview.TGIS_ControlPrintPreviewForm.Preview | Constructors | Methods | Properties | Events

Show the print preview form and start preview generation.

Available also on: .NET WinForms | Java.

Syntax

// Delphi
public
  procedure Preview(
    const _printManager : TGIS_PrintManagerAbstract;
    const _customPage : String;
    var _scale : Double
  );
// C++ Builder
public:
  void Preview(
    TGIS_PrintManagerAbstract* const _printManager,
    const UnicodeString _customPage,
    double &_scale
  );

Parameters

Name Type Description
_printManager TGIS_PrintManagerAbstract Print manager used to generate and print preview pages.
_customPage String Custom page definition passed to the print manager.
_scale Double Scale factor used for printing; if _scale = 0, the scale is calculated automatically to fit the printed extent.

Remarks

PURPOSE: Displays the preview form for the specified print manager and initializes preview state, including custom page settings and print scale handling.

BEHAVIOR: Opens the FMX preview user interface and starts previewing from the current page state. The scale value can be updated by the preview workflow when automatic fitting is used.

CONSTRAINTS: Printing and preview generation fail when GIS_Viewer.InPaint is True. Preview page numbering is 1-based, where page 1 is the first page.

2026/07/11 00:18

Page Tools