Configure the HTML output.
Syntax
fgl_report_configureHTMLDevice(
fromPage INTEGER,
toPage INTEGER,
embedImages INTEGER,
imageGenerationDirectory STRING,
imageURLPrefix STRING,
removeWhitespace INTEGER,
ignoreRowAlignment INTEGER,
ignoreColumnAlignment INTEGER,
removeBackgroundImages INTEGER )
- fromPage - Selects the lower bound of the range of pages to include in the
HTML document. The default value is 1.
- toPage - Selects the upper bound of the range of pages to include in the HTML
document. By default all pages are included.
- embedImages - Specifies whether to embed images in the resulting HTML output.
By default this is not the case.
- imageGenerationDirectory - If images are not embedded, this property
specifies the directory into which generated images are written. The directory needs to exist, it is
not created. Note that the urls that are created will not take this value into account. By default,
the urls that are created contain the image name only, so that the images are expected to reside in
the same directory as the document. If needed, the url prefix for the generated urls can be changed
with the property imageURLPrefix.
- imageURLPrefix - If images are not embedded, this property specifies the
prefix of the urls of the generated images. As an example consider that an image of the name
"12345.png" is created, and that this property is set to the value "./images/"; then the "src"
attribute of the generated "img" element would be set to "./images/12345.png".
- removeWhitespace - Controls whether cells should be created for empty
strings. By default whitespace is stripped from the document.
- ignoreRowAlignment - When set, only those objects that are entirely above or
entirely below each other will go in separate rows. When set, the option reduces the amount of rows,
thereby losing the horizontal alignment. The placement is not changed so that stacked items remain
stacked. By default row alignment is not ignored.
- ignoreColumnAlignment - When set, only those objects that are entirely to the
left or entirely to the right of each other will go in separate columns. When set, the option
reduces the amount of columns, thereby losing the vertical alignment. The placement is not changed
so that adjacent items remain adjacent. By default column alignment is not ignored.
- removeBackgroundImages - Controls the behavior when an IMAGEBOX is partially
obscured by another element. When set, the image is removed from the resulting document; otherwise,
the handling is as in any other case of overlapping items. By default, background images are
removed.
Usage
Function to configure the HTML output.
This function is applicable when HTML 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). If the HTML document should be written to a file, the general
functions fgl_report_setOutputFileName and fgl_report_selectPreview are available for this purpose.
See Usage.