PAGE BREAK
PAGE BREAK {( * | > )}
| Parameter | Type | Description | |
|---|---|---|---|
| * | > | → | * Cancel printing job started with Print form, or > Force one printing job |
This command is not thread-safe, it cannot be used in preemptive code.
Description
PAGE BREAK triggers the printing of the data that has been sent to the printer and ejects the page. PAGE BREAK is used with Print form (in the context of the On Printing Detail form event) to force page breaks and to print the last page created in memory. Do not use PAGE BREAK with the PRINT SELECTION command. Instead, use Subtotal or BREAK LEVEL with the optional parameter to generate page breaks.
The * and > parameters are both optional.
The * parameter allows you to cancel a print job started with the Print form command. Executing this command immediately stops the print job in progress.
Note: Under Windows, this mechanism can be disrupted by the spooling properties of the print server. If the printer is configured to start printing immediately, cancelling will not be effective. For the PAGE BREAK(*) command to operate correctly, it is preferable to choose the "Start printing after last page is spooled" property for the printer.
The > parameter modifies the way in which the PAGE BREAK command behaves. This syntax has two effects:
- It holds the print job open until the PAGE BREAK command is executed again without a parameter.
- It gives priority to the print job. No other printing can take place until the print job is finished.
The second option is particularly useful when used with a spooled print job. The > parameter guarantees that the print job will be spooled to one file. This will reduce printing time.
Note: When screen printing, if the user clicks on Cancel in the print preview dialog box, the PAGE BREAK command sets the system variable OK to 0.
Example 1
See example for the Print form command.
Example 2
Refer to the example of the SET PRINT MARKER command.