APRINTERS( ) (Función)
Incluye en una matriz de variables los nombres de las impresoras instaladas actualmente en el Administrador de impresión de Windows.
APRINTERS(ArrayName)
Valores devueltos
Numeric
Parámetros
- ArrayName
Especifica el nombre de la matriz que contiene los nombres de las impresoras instaladas, junto con sus puertos. Si la matriz incluida no existe, Visual FoxPro la creará automáticamente. Si la matriz existe y no es suficientemente grande para contener toda la información de impresoras, Visual FoxPro aumentará automáticamente el tamaño de la misma para dar cabida a toda la información. Si la matriz es mayor de lo necesario, Visual FoxPro reducirá su tamaño. Si la matriz existe y APRINTERS(°) devuelve 0 porque no hay ninguna impresora instalada, la matriz permanecerá inalterada. Si la matriz no existe y APRINTERS(°) devuelve 0, la matriz no se creará.
Observaciones
APRINTERS( ) crea una matriz de dos dimensiones. La primera columna contiene los nombres de las impresoras instaladas actualmente, mientras que la segunda columna contiene los puertos a los que están conectadas estas impresoras.
APRINTERS( ) devuelve el número de impresoras instaladas. Si no hay ninguna impresora instalada, devolverá 0.
Visual FoxPro obtiene de Windows los nombres de las impresoras instaladas y sus puertos. Sin embargo, Visual FoxPro no comprueba si las impresoras están conectadas realmente al equipo.
Ejemplo
El ejemplo siguiente utiliza APRINTERS( ) para crear una matriz llamada gaPrinters que contiene los nombres y puertos de impresoras instaladas. A continuación se muestran las impresoras y sus puertos. Si no hay ninguna impresora instalada, aparece un mensaje.
IF APRINTERS(gaPrinters) > 0 && If there are installed printer drivers
CLEAR && Clear the main Visual FoxPro window
DISPLAY MEMORY LIKE gaPrinters && Display the printers and ports
ELSE && Otherwise, no printer are installed
WAIT WINDOW 'No printers installed.'
ENDIF