PRINTSTATUS( )

Topic group Related topics Example

Returns true if the print device is ready to accept output.

Syntax

PRINTSTATUS([<port name expC>])

<port name expC>

A character expression such as "lpt1" that identifies the printer port to check.

Description

Use PRINTSTATUS( ) to determine whether you've designated a printer port as an output device with SET PRINTER TO <port name expC>. In dBASE Plus, the Windows Print Manager spools print output to and manages the printer port. Therefore, the Print Manager informs you when a printer isn't ready to receive output.

If you don't pass <port name expC> to PRINTSTATUS( ), it checks the default port you specified with SET PRINTER TO. PRINTSTATUS( ) returns only false if you haven't specified a printer port with SET PRINTER TO or if the port you specify hasn't been set with SET PRINTER TO.

Note

dBASE Plus automatically executes SET PRINTER TO on startup if the WIN.INI file contains a valid printer definition. See your Windows documentation for information on WIN.INI settings.