The Runtime Class

The Runtime class provides methods that simplify the creation of dynamic designs that change behavior based on the runtime setup.

Methods

Class methods are static methods that do not require an object. The method name is prefixed by the class name.

Table 1. Class Methods (Static Member Methods)
Name Description
Numeric getDebugLevel()
Returns the current debug level specified in the environment variable GREDEBUG, or 0 if no debug level was set.
String  getEnvironmentVariable(String variableName)
Returns the value of the specified environment variable.
String  getOutputDeviceName()
Returns the output device name selected in the API call fgl_report_selectDevice.
String  getPrinterMediaName()
Returns the media name specified in the API call fgl_report_setPrinterMediaName.
String  getPrinterMediaSizeName()
Returns the media size name specified in the API call fgl_report_setPrinterMediaSizeName.
String  getPrinterMediaTray()
Returns the media tray name specified in the API call fgl_report_setPrinterMediaTray.
String  getPrinterName()
Returns the printer name specified in the API call fgl_report_setPrinterName.
String  getSVGPaperSource()
Returns the paper source specified in the API call fgl_report_setSVGPaperSource.
String  getSVGPrinterName()
Returns the printer name specified in the API call fgl_report_setSVGPrinterName.
Boolean inDesigner()
Returns TRUE if the report is currently being edited in Genero Studio; otherwise FALSE.
Boolean producingBrowserOutput()
Returns TRUE if the device name selected in the API call fgl_report_selectDevice was "Browser"; otherwise FALSE.
Boolean producingExcelOutput()
Returns TRUE if the device name selected in the API call fgl_report_selectDevice was "XLS" or "XLSX"; otherwise FALSE.
Boolean producingHLPXMLOutput()
Returns TRUE if the device name selected in the API call fgl_report_selectDevice was "HLPXML"; otherwise FALSE.
Boolean producingHTMLOutput()
Returns TRUE if the device name selected in the API call fgl_report_selectDevice was "HTML"; otherwise FALSE.
Boolean producingImageOutput()
Returns TRUE if the device name selected in the API call fgl_report_selectDevice was "Image"; otherwise FALSE.
Boolean producingOORTFOutput()
Returns TRUE if the device name selected in the API call fgl_report_selectDevice was "OORTF"; otherwise FALSE.
Boolean producingPDFOutput()
Returns TRUE if the device name selected in the API call fgl_report_selectDevice was "PDF"; otherwise FALSE.
Boolean producingPostscriptOutput()
Returns TRUE if the device name selected in the API call fgl_report_selectDevice was "Postscript"; otherwise FALSE.
Boolean producingPrinterOutput()
Returns TRUE if the device name selected in the API call fgl_report_selectDevice was "Printer"; otherwise FALSE.
Boolean producingPXMLOutput()
Returns TRUE if the device name selected in the API call fgl_report_selectDevice was "PXML"; otherwise FALSE.
Boolean producingRTFOutput()
Returns TRUE if the device name selected in the API call fgl_report_selectDevice was "RTF"; otherwise FALSE.
Boolean producingSVGOutput()
Returns TRUE if the device name selected in the API call fgl_report_selectDevice was "SVG"; otherwise FALSE.
Boolean producingXLSOutput()
Returns TRUE if the device name selected in the API call fgl_report_selectDevice was "XLS"; otherwise FALSE.
Boolean producingXLSXOutput()
Returns TRUE if the device name selected in the API call fgl_report_selectDevice was "XLSX"; otherwise FALSE.
Boolean producingForPreview()
Returns TRUE if preview was selected in the API call fgl_report_selectPreview; otherwise FALSE.
Boolean xlsPagesAreMerged()
Returns TRUE if page merging was selected in the API call fgl_report_configureXLSDevice; otherwise FALSE.

Usage

The class provides a number of methods that simplify the job of creating dynamic designs that change behavior based on the runtime setup.

With RTL classes, it is not possible to create and subclass objects. The new keyword is not supported.

The methods can be used from within RTL expressions. Some common uses might be:

  • To suppress headers and footers when Excelâ„¢ output is selected.
  • To conditionally Insert a logo based on the printer tray is selected.
  • To set a background color when debugging is enabled

These static methods do not require a Runtime object instance. When you invoke the method, it is prefixed with the Runtime class name and the '.' For example, you can suppress a header by setting its " visibilityCondition" property to this expression:

"!Runtime.producingExcelOutput()"