PRINTERS LIST

version 2003

PRINTERS LIST (namesArray{; locationsArray{; modelsArray}})

Parameter	Type		Description
namesArray	Text Array		Printer names
locationsArray	Text Array		Printer locations
modelsArray	Text Array		Printer models

Note: This command does not work under MacOS 9.

The PRINTERS LIST command fills in the array(s) passed as parameter(s) with the names as well as, optionally, the locations and models of the available printers for the machine.

Note: If the printers are managed using a print server (spooler), the complete access path (under Windows) or the name of the spooler (under MacOS) is returned.

Pass the name of a text array in the namesArray parameter. After command execution, this array will contain the names of available printers. If you pass the optional locationsArray and modelsArray arrays, you will retrieve the network location (or local port) and model for each printer.

Note: The locationsArray and modelsArray parameters can only be used under Windows.

Use the SET CURRENT PRINTER and Get current printer commands to modify or get the selected printer in 4D.

Under Windows, the name of a printer can be modified manually at the operating system level. On the other hand, its location and model type are linked to its physical characteristics. Therefore, you can use the optional array values to check the characteristics of the selected printer — typically, you can check that all the client machines use the same printer.

Under MacOS, this check can be carried out using the name of the printer (name of the print server), which is the same for each machine that is connected.

Get current printer, SET CURRENT PRINTER.

The system variable OK is set to 1 if the command has been executed correctly; otherwise, it is set to 0 and the arrays are returned empty.