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). You must specify this value.
  2. paperHeight - height of the page (e.g. a4length). You must specify this value.
  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. The value is optional (indicated by passing null). In this case 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. The value is optional (indicated by passing null). In this case the height specified in the 4rp file is used.
  5. labelsPerRow - the number of labels across. You must specify this value.
  6. labelsPerColumn - the number of labels down. You must specify this value.

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.