Stores information about currently-available printers into an array.
Note: |
---|
The behavior of this function is OS (operating system) - specific. Visual FoxPro may or may not check to see if the printers are actually connected to your computer when it prepares this list, and the list may include all printers installed as printer setups, or only those available on the current network. |
APRINTERS(ArrayName [, nValue]) |
Parameters
- ArrayName
-
Specifies the name of the array containing information about printers.
Note: If the array you include does not exist, Visual FoxPro automatically creates the array. If the array exists but is not large enough to contain all the information, Visual FoxPro increases the size of the array to accommodate the information. If the array is larger than necessary, Visual FoxPro truncates the array. If the array exists but APRINTERS(В ) returns 0 because no printers are available, the array remains unchanged. If the array does not exist, and APRINTERS(В ) returns 0, the array is not created.
- [, nValue]
-
Specifies a value that creates a two-column array or five-column array. Each row in the array contains information about a printer.
The following table describes the possible values of nValue.
nValue Description 0 or omitted
Return a two-column array containing the following items beginning with the first column:
-
Printer name.
-
Name of the port to which the printer is connected.
1
Return a five-column array containing the following items beginning with the first column:
-
Printer name.
-
Name of the port to which the printer is connected.
-
Name of the printer driver.
-
Printer comment.
-
Printer location.
-
Printer name.
Return Value
Numeric. APRINTERS(В ) returns the number of rows in the array or 0 when no printers are available.
Example
The following example creates an array named gaPrinters
if any printers are available and displays information about those printers. Otherwise, it displays a message indicating that APRINTERS(В ) is unable to retrieve information about any printers.
В | Copy Code |
---|---|
IF APRINTERS(gaPrinters) > 0 CLEAR && clear the current output window DISPLAY MEMORY LIKE gaPrinters && show the contents of the array ELSE WAIT WINDOW 'No printers found.' ENDIF |