Prints the contents of a DataWindow control or DataStore as a print job.
PrintDataWindow ( printjobnumber, dwcontrol )
Argument |
Description |
|---|---|
printjobnumber |
The number the PrintOpen function assigned to the print job |
dwcontrol |
The name of the DataWindow control, child DataWindow, or DataStore containing the DataWindow object you want to print |
Integer. Returns 1 if it succeeds and -1 if an error occurs. If any argument’s value is null, PrintDataWindow returns null.
Do not use PrintDataWindow with any Print functions except PrintOpen and PrintClose.
When you use PrintDataWindow with PrintOpen and PrintClose, you can print several DataWindows in one print job. The information in each DataWindow control starts printing on a new page.
Required third-party software
You must install the FieldSoftware PrinterCE SDK before you
can use print methods in PocketBuilder applications deployed to
a Pocket PC device or emulator. An evaluation version of this software
is available from the FieldSoftware Web site.
When you print a DataWindow using PrintDataWindow, PocketBuilder uses the fonts and layout specified in the computer’s printer setup, not the fonts and layout specified in the DataWindow. The PrintDefineFont and PrintSetFont methods also have no effect.
When the DataWindow’s presentation style is RichTextEdit, each row begins a new page in the printed output.
For information on skipping individual pages with return codes in the PrintPage event, see the Print function.
These statements send the contents of three DataWindow controls to the current printer in a single print job:
long job
job = PrintOpen( )
// Each DataWindow starts printing on a new page.
PrintDataWindow(job, dw_EmpHeader)
PrintDataWindow(job, dw_EmpDetail)
PrintDataWindow(job, dw_EmpDptSum)
PrintClose(job)
