Display a Print Setup dialog box

WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows




Return value


%SYNMSW_PRINTSETUP returns true if a printer was selected. If the user cancels or an error occurs, %SYNMSW_PRINTSETUP returns false. (^VAL)


The %SYNMSW_PRINTSETUP function displays a standard Windows Print Setup dialog box, where users can change the default printer or printer properties to which an LPQUE statement will print when the LPNUM qualifier is not specified. (Note that these selections have no impact whatsoever on %SYNMSW_PRINTQUERY.)

Before %SYNMSW_PRINTSETUP is called, the default printer is the printer selected as the system default in “Devices and Printers” in Windows Control Panel. %SYNMSW_PRINTSETUP does not change this system default; the default is only changed for the current execution, or until %SYNMSW_PRINTSETUP is called again. When a program is run again, the default reverts to the default printer specified in Print Manager.

Using the Print Setup dialog box

With the Print Setup dialog box (figure 1), the user can select a printer from the printer list set up in Print Manager and select page and orientation characteristics.   

1. The Print Setup dialog box.

Selecting the Properties button displays the Document Properties dialog box (figure 2). The user can now select graphics resolutions, set optimizations, and select printer‑specific options such as duplex printing and color/monochrome printing.

2. The Document Properties dialog box.

Selecting the Network button on the Print Setup dialog displays a dialog where the user can select a different network printer and view printer information such as the print job status, print job description, and the number of documents waiting.

See also

"Printing on Windows" in the “Windows Development” chapter of the Professional Series Portability Guide.