+---------------------------------+
|           SET PDSETUP           |
+---------------------------------+
SET PDSETUP TO [[<expC>
        [, <expr1> [, <expr2> ... ]]]
        [WITH <expr3> [, <expr4>... ]]]

-----------------------------------
SET PDSETUP loads a printer driver setup.
-----------------------------------

SET PDSETUP loads a printer driver setup or clears the current printer
driver setup.  A printer driver setup is a combination of settings that
include the printer driver program and printing information such as page
orientation, default font size and style, margins and so on.

Printer driver setups are stored in your FoxPro resource file,
FOXUSER.DBF, and can be created interactively and assigned a name in the
Printer Setup Editing dialog.  A printer driver setup can also be loaded
or cleared with the _PDSETUP system memory variable.

When SET PDSETUP is issued, the current printer setup interface
application is executed.  The interface application is passed the name
of the printer driver setup included in SET PDSETUP.  The printer setup
interface application can be specified with the _GENPD system memory
variable.  The default interface application is GENPD.APP, the printer
setup interface application included with FoxPro.

Clauses
-------

<expC>
        You can load a printer driver setup by including its name in <expC>.

        When you load a printer driver setup, the name of the setup is stored
in the _PDSETUP system memory variable and a special memory variable
array, _PDPARMS, can be created.

        If the printer driver setup name you include in <expC> does not exist
in your resource file, the current printer driver setup application is
executed so you can create a setup with this name.  If the current
printer driver setup application is GENPD.APP (the interface application
included with FoxPro), the Printer Setup Editing dialog appears so you
can create the setup.

        If the name begins with a dash (-), the _GENPD program will not be
executed, but the name following the dash is stored in _PDSETUP.

        If you issue the command SET PDSETUP TO without <expC>, the current
printer driver setup is cleared, the null string is stored in _PDSETUP,
and the _PDPARMS array is cleared from memory.

        A default printer driver setup can be loaded when you start FoxPro by
including the following line in CONFIG.FP.

        PDSETUP = '<setup name>'

        <setup name> in the name of the setup to load when FoxPro is started.
Be sure to enclose the setup name in quotation marks.  The default
printer driver setup specified in your CONFIG.FP takes precedence over a
default printer driver setup specified in the Printer Driver Setup
dialog.

<expr1> [, <expr2> ... ]
        You can also include any number of optional parameters <expr1>, <expr2>
... with the printer driver setup name.  These parameters are passed to
the printer setup interface application, and may be of any type
(character, numeric, logical, etc.).  The first line in your printer
setup interface application must be a PARAMETERS statement to accept the
parameters passed from SET PDSETUP.

        If you are using GENPD.APP, the default printer setup interface
application, do not include these optional parameters.  GENPD.APP does
not accept parameters passed from SET PDSETUP and will generate an
error.

WITH <expr3>, [<expr4> ... ]
        The optional WITH clause can be included in SET PDSETUP to create the
special _PDPARMS printer array.  Each parameter <expr3>, <expr4> becomes
an element in _PDPARMS.  The first parameter <expr3> is stored in the
first element of _PDPARMS, the second parameter <expr4> is stored in the
second element and so on.  These parameters may be of any type
(character, numeric, logical, etc.).

        If you are using GENPD.APP, the default printer setup interface
application, the parameters you include are overwritten by the
application.

-----------------------------------

See Also:  _GENPD, _PDRIVER, _PDSETUP, SET PRINTER

-----------------------------------