fgl_report_setPageMargins

Configure the logical margins of a report.

Syntax

fgl_report_setPageMargins(
   topMargin STRING,
   bottomMargin STRING,
   leftMargin STRING,
   rightMargin STRING)
  1. topMargin - top margin value of the logical page (e.g. 0.5cm).
  2. bottomMargin - bottom margin value of the logical page (e.g. 0.5cm).
  3. leftMargin - left margin value of the logical page (e.g. 0.5cm).
  4. rightMargin - right margin value of the logical page (e.g. 0.5cm).

Usage

Function that configures the logical margins of a report.

The logical margins of the report are read from the 4rp file. This function is used to override the values found there.

For BDL ASCII reports (compatibility reports, no 4rp file is specified), this function is used to set the values of the parameters:

For additional information about the units that can be used to specify the margin values, see Dimension Resolver.

In the case of label printing (see fgl_report_selectLogicalPageMapping), this function specifies the margins within a label. Similarly, when multi page output is selected (see fgl_report_selectLogicalPageMapping) the values specify the margins of the logical pages which can be smaller than the physical margins since the required width is not limited by device limitations but by aesthetic aspects only.

For an example of Genero code using a reporting function, see Using report output functions. This example may not use the specific function discussed in this topic, however it provides details on where you would place this (and other) report output functions.