fgl_report_configureLabelOutput

Configures the physical layout of a label page.

Syntax

fgl_report_configureLabelOutput(
   paperWidth STRING,
   paperHeight STRING,
   labelWidth STRING,
   labelHeight STRING,
   labelsPerRow INTEGER,
   labelsPerColumn INTEGER)
  1. paperWidth - width of the page (e.g. a4width).
  2. paperHeight - height of the page (e.g. a4length).
  3. labelWidth - Physical width of a label (e.g. 99.1mm) The value specified here should be the same or larger than the width in the 4rp file. This parameter is optional; pass a value of NULL if you don't want to set its value. If no value is specified, the width specified in the 4rp file is used.
  4. labelHeight - Physical height of a label (e.g. 42.3mm) The value specified here should be the same or larger than the height in the 4rp file. This parameter is optional; pass a value of NULL if you don't want to set its value. If no value is specified, the height specified in the 4rp file is used.
  5. labelsPerRow - the number of labels across.
  6. labelsPerColumn - the number of labels down.

For additional information about the strings that can be used to specify the parameter values, see Dimensions.

Usage

Function that configures the physical layout of a label page.

This function is applicable when selecting "label" as the mapping option by calling the function fgl_report_selectLogicalPageMapping. This figures the physical layout by specifying the paper dimensions, the physical label size and the n x m layout. The physical margins (distance between page border and label) are specified by calling fgl_report_setPaperMargins.

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.