Share via

LABEL-Befehl

  • Artikel

Druckt Etiketten aus einer Tabellendatei und einer Etikettendefinitionsdatei.

LABEL [FORM FileName1 | FORM ?] [ENVIRONMENT] [Scope]
   [FOR lExpression1] [WHILE lExpression2] [NOCONSOLE]
   [NOOPTIMIZE] [PDSETUP] [PREVIEW [NOWAIT]] [NAME ObjectName]
   [TO PRINTER [PROMPT] | TO FILE FileName2]

Parameter

  • FORM FileName1
    Gibt den Namen einer Etikettendefinitionsdatei an, deren Etiketten gedruckt werden sollen. Die Standarderweiterung für eine Etikettendefinitionsdatei lautet LBX. Befindet sich diese Datei nicht auf dem Standardlaufwerk oder im aktuellen Verzeichnis, müssen Sie zusätzlich die Laufwerkbezeichnung und das Verzeichnis angeben.

  • FORM ?
    Zeigt das Dialogfeld Öffnen an, in dem Sie eine vorhandene Etikettendatei wählen können.

  • ENVIRONMENT
    Wird nur aus Gründen der Abwärtskompatibilität mit Etiketten aus Version 2.x bereitgestellt. Zur Wiederherstellung der einem Visual FoxPro-Etikett zugeordneten Datenumgebung legen Sie die AutoOpenTables-Eigenschaft der Datenumgebung auf Wahr (.T.) fest. Um sicherzustellen, dass die Etikettenumgebung nach dem Drucken des Etiketts geschlossen wird, setzen Sie die AutoCloseTables-Eigenschaft der Datenumgebung auf Wahr (.T.). Dies ist ebenfalls die Standardeinstellung.

    Beim Erstellen oder Ändern von Etiketten können Sie die aktuelle Visual FoxPro-Datenumgebung zusammen mit der Etikettendefinitionsdatei speichern. Beim Speichern der Visual FoxPro-Datenumgebung werden zusätzliche Datensätze für alle geöffneten Tabellen und Indexdateien, die Indexreihenfolge sowie die Beziehungen zwischen den Tabellen in die Etikettendefinitionsdatei aufgenommen.

  • Scope
    Gibt einen Bereich von Datensätzen an. Nur die in diesen Bereich fallenden Datensätze werden gedruckt,. Die Bereichsklauseln sind: ALL, NEXT nRecords, RECORD nRecordNumber und REST. Weitere Informationen zu Bereichsklauseln finden Sie unter Bereichsklauseln und Überblick über die Sprache. Befehle, bei denen ein Geltungsbereich (Scope) enthalten ist, funktionieren nur für die Tabelle des aktiven Arbeitsbereichs.

    Der Standardgeltungsbereich für LABEL ist ALL und umfasst alle Datensätze.

  • FOR lExpression1
    Bezeichnet eine Bedingung, nach der nur die Datensätze gedruckt werden, die die logische Bedingung lExpression1 erfüllen. Mit diesem Argument können Sie Datensätze herausfiltern, die Sie nicht drucken möchten.

    Rushmore optimiert eine mit LABEL ...FOR erstellte Anfrage, sofern lExpression1 ein optimierbarer Ausdruck ist. Die beste Leistung erreichen Sie, indem Sie in der FOR-Klausel einen optimierbaren Ausdruck verwenden.

    Weitere Informationen finden Sie unter SET OPTIMIZE und Verwenden von Rushmore zum Beschleunigen des Datenzugriffs.

  • WHILE lExpression2
    Bezeichnet eine Bedingung, nach der so lange Datensätze gedruckt werden, wie die Auswertung des logischen Ausdrucks lExpression2 Wahr (.T.) ergibt.

  • NOCONSOLE
    Unterdrückt die Anzeige von Etiketten im Visual FoxPro-Hauptfenster oder in einem benutzerdefinierten Fenster, wenn Etiketten gedruckt oder in eine Datei ausgegeben werden.

  • NOOPTIMIZE
    Deaktiviert die Rushmore-Optimierung für LABEL.

    Weitere Informationen finden Sie unter SET OPTIMIZE und Verwenden von Rushmore zum Beschleunigen des Datenzugriffs.

  • PDSETUP
    Lädt das Druckertreiber-Setup.

    In Visual FoxPro kann mit PDSETUP ein Druckertreiber-Setup zum Drucken von in FoxPro für MS-DOS erstellten zeichenorientierten Etiketten angegeben werden. Beim Druck von grafikorientierten Etiketten, die in Visual FoxPro erstellt wurden, wird PDSETUP ignoriert.

  • PREVIEW [NOWAIT]
    Stellt die Etiketten vor dem Drucken in einem Seitenansichtsfenster dar, druckt diese jedoch nicht. Zum Drucken müssen Sie LABEL anschließend noch einmal ohne die Klausel PREVIEW aufrufen.

    In Visual FoxPro können Sie die optionale NOWAIT-Klausel einfügen, so dass Visual FoxPro das Programm zur Laufzeit weiter ausführt, ohne auf das Schließen des Seitenansichtsfensters zu warten. Stattdessen führt Visual FoxPro das Programm bei geöffnetem Seitenansichtsfenster weiter aus.

  • NAME ObjectName
    Gibt den Namen einer Objektvariablen für die Datenumgebung eines Etiketts an. Die Datenumgebung und die Objekte in der Datenumgebung besitzen Eigenschaften und Methoden (z. B. AddObject), die entweder gesetzt oder zur Laufzeit aufgerufen werden müssen. Die Objektvariable bietet Zugriff auf diese Eigenschaften und Methoden. Wird NAME nicht angegeben, verwendet Visual FoxPro standardmäßig den Namen der Etikettendatei, auf die in dem Code, der den Ereignissen zugeordnet ist, verwiesen werden kann.

  • TO PRINTER [PROMPT]
    Sendet ein Etikett an den Drucker. Sie können die optionale PROMPT-Klausel aufnehmen, um das Dialogfeld Drucken vor Beginn des Druckvorgangs aufzurufen.

  • TO FILE FileName2
    Gibt zeichenorientierte Etiketten, die in FoxPro für MS-DOS erstellt wurden, in die in FileName2 angegebene Textdatei aus. Die mit TO FILE erstellte Datei besitzt die Standarderweiterung TXT.

Hinweise

Etikettendefinitionsdateien werden mit MODIFY LABEL oder CREATE LABEL erstellt.

Wird LABEL ohne zusätzliche Argumente aufgerufen, wird das Dialogfeld Öffnen mit einer Liste der wählbaren Etikettendateien angezeigt.

Siehe auch

CREATE LABEL | MODIFY LABEL | Bereichsklauseln | Überblick über die Sprache