Freigeben über


APRINTERS( )-Funktion

Speichert die Namen der aktuell im Windows-Druckmanager installierten Drucker in einem Variablenarray.

APRINTERS(ArrayName)

Rückgabewerte

Numerisch

Parameter

  • ArrayName
    Legt den Namen des Arrays fest, das die Namen der installierten Drucker und deren Anschlüsse enthält. Ist das angegebene Array nicht vorhanden, wird es von Visual FoxPro automatisch erstellt. Ist das Array vorhanden, aber nicht groß genug, um alle Druckerinformationen aufnehmen zu können, passt Visual FoxPro die Größe des Arrays automatisch entsprechend an. Ist das Array größer als notwendig, wird es abgeschnitten. Wenn das Array vorhanden ist und APRINTERS( ) 0 zurückgibt, weil keine Drucker installiert sind, werden keine Änderungen an dem Array vorgenommen. Ist das Array nicht vorhanden und gibt APRINTERS( ) den Wert 0 zurück, wird das Array nicht erstellt.

Hinweise

APRINTERS( ) erstellt ein zweidimensionales Array. Die erste Spalte enthält die Namen der aktuell installierten Drucker, die zweite Spalte enthält die Anschlüsse, über die die Drucker angesteuert werden.

APRINTERS( ) gibt die Anzahl der installierten Drucker zurück. Ist kein Drucker installiert, wird 0 zurückgegeben.

Visual FoxPro erhält die Namen der installierten Drucker und deren Anschlüsse von Windows. Hierbei prüft Visual FoxPro jedoch nicht, ob die Drucker tatsächlich an Ihren Computer angeschlossen sind.

Beispiel

Im folgenden Beispiel wird APRINTERS( ) zum Erstellen eines Arrays mit dem Namen gaPrinters verwendet, das die Namen und Anschlüsse installierter Drucker enthält. Anschließend werden die Drucker und deren Anschlüsse angezeigt. Sind keine Drucker installiert, wird eine Meldung angezeigt.

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

Siehe auch

GETPRINTER( ) | PRINTSTATUS( ) | PRTINFO( ) | SET PRINTER