Loads and executes the report that you specify. The report is run modally.

REPORT.RUNMODAL(Number [, ReqWindow] [, SystemPrinter] [, Record])

Parameters

Number

Type: Integer

The ID of the report that you want to run. You can use the Symbols option on the View menu to select the report from a list.

If the report that you specify does not exist, a run-time error occurs.

ReqWindow

Type: Boolean

Specifies whether the request window for the report will be displayed. The request window is part of the report object.

Specify true (default) to display the request window before running the report. Specify false to run the report without showing the request window.

SystemPrinter

Type: Boolean

Specifies whether to use the default Windows printer or use the Printer Selection table to find the right printer for this report. For example, if the report prints on continuous forms, you can set up an entry in the Printer Selection table to specify to always print this report on a specific printer.

Specify true to use the printer defined as the system printer. Specify false (default) to use the printer defined through the Printer Selection table.

Record

Type: Record

Specifies which record to use in the report. Any filters attached to the record that you specify will be used.

Remarks

Example

This example shows how to run a report. This example displays the request window and sends the report to the printer selected through the Printer Selection table.

	Copy Code
REPORT.RUNMODAL(1001);

This example shows how to run a report. This example skips the request window, starts the report immediately, and sends the report to the printer selected in the Printer Selection table.

	Copy Code
REPORT.RUNMODAL(1001, FALSE);

This example shows how to run a report. This example skips the request window and starts the report immediately. It sends the report to the system printer instead of the printer selected through the Printer Selection table.

	Copy Code
REPORT.RUNMODAL(1001, FALSE, TRUE);

See Also