Change paper and page settings with Swift APIs
The default paper settings for a report are specified in the .4rp file. Override the defaults in your report program with Swift reporting APIs.
Each report design document includes details about the page orientation, the page size of the report, and the report margins. These values are set when a report is first created, and can be altered by the report designer. See Specify the paper settings of a report for details about setting these values within the report design document (.4rp).
In the Swift report application, you can override these report page and paper settings, thanks to the order of precedence for paper settings:
Paper settings order of precedence
- In the report application using reporting APIs.
- In the report design document (.4rp).
- GRW default values.
Change the page height and width
The initial page height is specified in the report design document
(.4rp). In the report application, use the
configurePageSize() C API to modify the page height.
Change the report margins
The initial page margins are specified in the report design document
(.4rp). In the report application, use the
setPaperMargins() function of the C API to set the physical margins of
the page. Use the setPageMargins() function to modify the logical margins
of the report.
Set page orientation
The initial report size is set in the report design document (.4rp). In the report application, use C APIs to change the orientation. There is no method for changing the page orientation; you change the height and width of the paper to create a portrait or landscape orientation.
In this example, assume the initial report is a standard A4 portrait report. To change it
to an A4 landscape report, use the configurePageSize() function.
configurePageSize(rcPtr, a4length, a4width)