Specify whether the report is printed in portrait or landscape.


   orientationRequested String)
  1. orientationRequested - Valid values are "landscape" or "portrait".


This function can pre-select (in the case of printing via the print dialog) or set the value of the orientation property.

Normally this value should not be set. The value is set internally by analyzing the page's width and height values. If a page's height is greater than its width, the orientation is portrait, otherwise it is landscape.

However, some printers can be loaded with both portrait and landscape paper. Without the printing software being aware of what type is currently loaded, the wrong orientation setting can cause a misprint. In the case of matrix or label printers which can be loaded with paper of various dimensions (without the printer or the driver being aware of the current format), the value should be set to "portrait" for landscape reports when the printer contains landscape paper.

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.