![]() ![]() ![]() ![]() Gravitybox Schedule Primer
Page 95
1998-2004 Gravitybox Software LLC
canceled. This event is the place to remove any progress screen that may have been
displayed. If the PrintDone event is raised, the PrintCancel is not raised.
The PrintCancel event is raised when the print is canceled. All printing ceases and no
more pages are sent to the printer. A print may be canceled from the PrintProgress or
the PrintPageDone events. If canceled, the PrintDone event is not raised. These two
events are mutually exclusive.
The progress of completed pages maybe monitored, with the PrintPageDone event.
This event has several parameters. The Page parameter represents the absolute page
that was last printed. The PageX and PageY parameters represent the page in
horizontal and vertical coordinates. Finally the Cancel parameter allows for the
cancellation of printing, so no more pages are sent to the printer.
The event that is used to inform the user of the percent
complete is the PrintProgress event. This event returns a
Percent parameter that is the a value [0..100] of the percent
complete. The Cancel parameter allows for the cancellation of printing. If set to true, the
PrintCancel event is raised and the printing will not continue.
Table 9.2
Print Events
PrintCancel
This event is raised if the printing was canceled.
PrintDone
This event is raised when the printing completes normally.
PrintPageDone
This event is raised for every page that was sent to the
printer.
PrintProgress
This event is raised when at intervals to give feedback on
the progress of printing.
PrintStart
This event is raised when the printing begins.
The printing creates temp files, in the windows temp directory. Needed are several
hundred kilobytes per page. The amount varies but it is probably a good idea to have
one-half megabyte per page free on the hard disk. Computers running low on disk
space should not use the printing functionality. This is not a problem in most cases.
However, printing a schedule with a small value for ScheduleIncrement and a very large
range of days (i.e. a year) could use quite a bit of temp space. All the temp space is
released upon the printing completing or being canceled.
To aid in printer selection, there is a provided collection of printers. This collection is
named SchedulePrinters. It is a list of all valid printer names that can be used with the
DeviceName parameter of the GoPrint method.
Table 9.3
SchedulePrinters Collection Definition
Count
This method returns the total number of printer in the collection. This is
the number of printers installed on the current system.
Quick Tip
There are several Print
events
that inform you know of the printing
progress.
|