fgl_report_configureTXTDevice

Configure the TXT (ASCII) output.

Syntax

fgl_report_configureTXTDevice(
   fromPage INTEGER,
   toPage INTEGER,
   removeWhitespace BOOLEAN,
   ignoreRowAlignment BOOLEAN,
   ignoreColumnAlignment BOOLEAN,
   sizeComputationMethod STRING,
   sizeComputationLimit INTEGER)
  1. fromPage - Selects the lower bound of the range of pages to include in the TXT document. The default value is 1.
  2. toPage - Selects the upper bound of the range of pages to include in the TXT document. All pages are included by default.
  3. removeWhitespace - Controls whether cells are created for empty strings. Whitespace is stripped from the document by default.
  4. ignoreRowAlignment - When set, only the objects that are entirely above or entirely below each other go in separate rows. This option reduces the amount of rows. As a result, it looses the horizontal alignment. The topology is not effected so that stacked items remain stacked. By default row alignment is ignored.
  5. ignoreColumnAlignment - When set, only those objects that are entirely to the left or entirely to the right of each other go in separate columns. This option reduces the amount of columns. As a result, it looses the vertical alignment. The topology is not changed so that adjacent items remain adjacent. By default column alignment is ignored.
  6. sizeComputationMethod - One of PerPage, AfterNPages, AfterNUnchagedPages and AtEnd. Controls the methods used for computing the page width. By default the page width is computed per page so that flushing is immediate and memory usage is low. The option AtEnd may exhaust memory on large reports.
  7. sizeComputationLimit - Specifies n for the size computation methods AfterNPages and AfterNUnchangedPages.

Usage

This function is applicable when the TXT output has been selected by a call to the function fgl_report_selectDevice. All arguments to this function are optional (indicated by passing a null value). In case that the TXT document should be written to a file, the general function fgl_report_setOutputFileName and fgl_report_selectPreview (4GL only) are available for this purpose.