PRTDIALOG

Syntax

STRING = PRTDIALOG(win as POINTER,vStart as INT BYREF,vEnd as INT BYREF,vCopies as INT BYREF,vCollate as INT BYREF)

Description

Opens the standard system printer dialog and returns the name of the selected printer.

Parameters

win - [in] Parent window, dialog or NULL

vStart - [in][out] Starting page number

vEnd - [in][out] Ending page number

vCopies - [in][out] Number of copies requested

vCollate - [in][out] Indicates whether program performs collate or printer handles internally.

Return value

The name of the selected print device or an empty string "" if the user cancels the dialog.

Remarks

The function returns the name of the selected printer and modifies the integer variables vStart, vEnd, vCopies and vCollate to reflect the user's choices. Before using PRTDIALOG set the vStart and vEnd variables to indicate the number of pages available to print. If both are set to the same number then only the 'all pages' radio button will be available.

vCollate will be set to TRUE (1) only if the printer cannot handle collating and the user requests the function. vCopies will only be greater than one if the printer driver cannot handle multiple copies on its own.

See Also: OPENPRINTER

Example usage

DEF hPrt:UINT
DEF data:STRING
DEF name:STRING
DEF pagefrom,pageto,copies,collate:INT
pagefrom = 1
pageto = 1
copies = 1
name = PRTDIALOG(NULL,pagefrom,pageto,copies,collate)
hPrt = OPENPRINTER(name,"Test Document","TEXT")
IF (hPrt)
    data = "This is a test of printing"
    data = data + chr$(13)
    data = data + "This is line 2"
    WRITEPRINTER hPrt,data
    CLOSEPRINTER hPrt
ENDIF
 
END