orientation

Type: Integer

The orientation property of the Printer class contains the orientation of your printed output.

You can change the orientation property dynamically, to allow allocation of the page orientation to be used on a page-by-page basis.

Changing this property causes a newPage method to be executed before the orientation property is changed if the print is not at the start of a new page. Changing the orientation property also causes the pageHeight and pageWidth methods to return the appropriate values for the new page size.

Set this property to one of the global constants provided by the Printer category listed in the following table.

Global Constant	Integer Value	Action
Print_Landscape	2	Landscape (horizontal page orientation)
Print_Portrait	1	Portrait (vertical page orientation)

The code fragment in the following example shows the use of the orientation property.

app.printer.orientation := Print_Landscape;

The default value is Print_Portrait (portrait orientation).

For details about retaining the setting of this property when the printer is closed, see the Printer class retainCMDValues property.