PrintCancel

Description

Cancels printing and deletes the spool file, if any. Cancels printing of a print job that you opened with the PrintOpen function. The print job is identified by the number returned by PrintOpen.

For syntax for DataWindows and DataStores, see the PrintCancel method for DataWindows in the section called “PrintCancel” in DataWindow Reference.

Syntax

PrintCancel ( printjobnumber )

Argument

Description

printjobnumber

The number the PrintOpen function assigned to the print job


Return value

Integer. Returns 1 if it succeeds and -1 if an error occurs. If printjobnumber is null, PrintCancel returns null.

Usage

PrintCancel cancels the specified print job by deleting the spool file, if any, and closing the job. Because PrintCancel closes the print job, do not call the PrintClose function after you call PrintCancel.

Examples

In this example, a script for a Print button opens a print job and then opens a window with a cancel button. If the user clicks on the cancel button, its script sets a global variable that indicates that the user wants to cancel the job. After each printing command in the Print button's script, the code checks the global variable and cancels the job if its value is true.

The definition of the global variable is:

boolean gb_printcancel

The script for the Print button is:

long job, li
 
gb_printcancel = FALSE
job = PrintOpen("Test Page Breaks")
IF job < 1 THEN
   MessageBox("Error", "Can't open a print job.")
   RETURN
END IF
 
Open(w_printcancel)
 
PrintBitmap(Job, "d:\PB\bitmap1.bmp", 5, 10, 0, 0)
IF gb_printcancel = TRUE THEN
   PrintCancel(job)
   RETURN
END IF
 
... // Additional printing commands,
... // including checking gb_printcancel
 
PrintClose(job)
Close(w_printcancel)

The script for the cancel button in the second window is:

gb_printcancel = TRUE
Close(w_printcancel)

See also

Print

PrintClose

PrintOpen