|
the software that grows
with you
| |
|
V32PBeginDoc()
|
| Begins a print job with or without
preview window. |
|
Syntax
|
| V32BeginDoc( nPrinter, cTitle, nOrient,
nCopies, lPreview, cFont, nPoint, nWidth, nZoom, nPrintQuality,
nPaperLength, nPaperWidth, nDuplex, lMonoColor, nPaperSource, nPrintDlg ) |
|
Arguments
|
| Param |
Default |
Description |
| nPrinter |
0 |
One of the possible two values. 0-Default Printer,
99-Printer Selection Dialog. |
| cTitle |
Vouch32 |
Title to be displayed on the preview windows' title
bar. |
| nOrient |
0 |
0-Portrait 1-Landscape |
| nCopies |
1 |
Number of copies to be printed. |
| lPreview |
.F. |
Should preview window be opened or printing be
conducted at the background. |
| cFont |
Courier New |
Font name used for default font used for the
v32TextOut() functions. |
| nPoint |
12 |
Size of the font to be used as default. |
| nWidth |
0 |
Reserved for future use. |
| nZoom |
1 |
Zoom Factor to Open Preview Window. Valid
values 1 through 2 for best results. |
| nPrintQuality |
-4 |
DMRES_HIGH Prints in high resolution mode.
Valid values are, DMRES_DRAFT, DMRES_LOW, DNRES_MEDIUM, DMRES_HIGH.
( -1 - -4 ).
The alternative function to set this mode is V32PPrnQuality(
nPrnQuality ).
|
nPaperLength
nPaperSize |
Nil |
Specifies either the PageSize
( one of the predefined paper sizes, see Vouch32.ch ) or the user
defined paper length, ( in 10's of MM's ) If the value of
nPaperLength is < DMPAPER_USER ( 256 ), paper size will be taken
care of otherwise paper length will be considered.
Alternative function is V32PSetPageSize( nPageSize |
nPaperLength, nPaperWidth )
|
| nPaperWidth |
Nil |
If nPaperLength is > 256 only then this
property will be set. It must be in10 x MM's of paper width. |
| nDuplex |
1 |
Specifies the duplex mode for printing.
Can be one of these values DNDUP_SIMPLEX, DMDUP_VERTICAL,
DMDUP_HORIZONTAL.
Alternative function is V32PSetDuplex( nDuplex ).
|
| lMonoColor |
FALSE |
Specifies whether printing is in color or
mono ( grayscale ) mode. |
| nPaperSource |
Nil |
Specifies the paper source to be used
while printing. It can be one of the DMBIN_ constant ( see
Vouch32.ch ).
The alternative function is V32PSetBin( nPaperSource ).
|
| nPrintDlg |
1 |
Whether Vouc32 defined Print Dialog to
open or Windows default Print Dialog to open. Default is
PRINTDLG_VOUCH. The other value is PRINTDLG_WINDOWS.
|
|
|
Returns
|
| NIL |
|
Description
|
| <nZoom> is an appropriate solution
to display the preview dialog with height and width increased
proportionately multiplied by <nZoom>. The value must be below
2 to get a proper view. In my experience nZoom == 1.4 offers a very
pleasant window.
If <nPrinter> == 99 and <nPrintDlg> == 1, the following
Print dialog gets precedence over Windows default Print dialog. The dialog
contains preset attributes like <nPrinter>, <nOrient>, <lPreview>,
<lMono>, <nCopies>, <nPaperSize>, <nPrnQuality>,
<nDuplex> fowraded through V32PBeginDoc() and VPE's specific
functions, i.e., V32PSetDuplex(), V32PSetPrnQuality(), V32PSetPaperSize()
etc.
It is handy way to switch to desired functionality other than defined
by the application. It is even more appropriate to define <lPreview>
== FALSE in the code and then let the user set this property through this
dialog.
|
|
Usage
|
| |
|
Tips
|
|
|
