Report settings

Top  Previous  Next

The Report Settings dialogue is available from the “Report>Options...” menu. The dialogue has three pages.

 

On the first page you can see the general settings for the report:

 

clip0057

 

You can tie a report to one of the printers installed in the system. This means that the selected printer will become the default when printing that report. This might be useful in cases where there are several different printers in the system; e.g. text documents can be tied to monochrome printers, while documents with graphics tied to color capable ones. “Default” is listed in Printer settings - when this is selected, the report will not be tied to any particular printer but will be printed on the system's default printer.

 

You can also set the number of report copies to be printed and whether to collate the output. The value set in this dialogue will be shown in the “Print” dialogue when printing the report.

 

If the “Double pass” flag is checked report generation will be performed in two steps. During the first pass a draft report is created and divided into pages, but is not available for preview. In the second pass the draft report is converted to a standard report which is then saved in the preview stream.

 

Why are two passes necessary? Mostly this option is used in cases where a report needs access to the total number of pages in the report, i.e. for use as “Page 1 of 15”. The total number of pages is calculated during the first pass and is made available via the “TOTALPAGES” system variable. The most frequent mistake is to attempt to use this variable in a single-pass report, when the variable will return 0.

 

Another use for two passes is to perform some calculations in the first pass and display the results in the second pass. For example, when a sum is to be displayed in a group header instead of in the usual group footer. Calculations of this type are accomplished by writing report script code in the “OnBeforePrint” event of an object.

 

The “Print if empty” flag allows creation of a report containing no data lines. If this option is disabled blank reports will not be created.

 

The “Password” field enables the setting of a password, which must be entered before a report can be opened.

 

On the second page you can set up the report inheritance options:

 

clip0058

 

You will learn about inheritance later in the “Report inheritance” chapter. In this dialogue you can see the base report's name (if the report is inherited), detach the base report (in which case your report will be standalone and non-inherited) or inherit the report from one of the available base reports.

 

The third page of the dialogue allows you to set descriptive properties for the report:

 

clip0063

 

All fields on this page are for information purposes only and are not printable.