REPORT-Befehl

  • Artikel

Zeigt einen Bericht an oder druckt ihn unter Steuerung einer mit MODIFY REPORT oder CREATE REPORT angelegten Berichtsdefinitionsdatei.

REPORT FORM FileName1 | ? [ENVIRONMENT] [Scope] [FOR lExpression1]
   [WHILE lExpression2] [HEADING cHeadingText] [NOCONSOLE]
   [NOOPTIMIZE] [PLAIN] [RANGE nStartPage [, nEndPage]]
   [PREVIEW [[IN] WINDOW WindowName | IN SCREEN] [NOWAIT]]
   [TO PRINTER [PROMPT] | TO FILE FileName2 [ASCII]] [NAME ObjectName]
   [SUMMARY]

Parameter

  • FileName1
    Gibt den Namen der zu druckenden Berichtsdefinitionsdatei an. In dieser Visual FoxPro-Version wird dieser Parameter auch an das Dialogfeld Druckerwarteschlange übergeben.

  • ?
    Zeigt das Dialogfeld Öffnen an, aus dem Sie eine Berichtsdatei wählen können.

  • ENVIRONMENT
    Wird aus Gründen der Abwärtskompatibilität mit Berichten aus Version 2.x bereitgestellt. Um die einem Visual FoxPro-Bericht zugeordnete Datenumgebung wiederherzustellen, setzen Sie die AutoOpenTables-Eigenschaft der Datenumgebung auf Wahr (.T.). Um sicherzustellen, dass die Berichtsumgebung nach dem Drucken des Berichts geschlossen wird, stellen Sie die AutoCloseTables-Eigenschaft der Datenumgebung auf Wahr (.T.). Auch dies ist die Standardeinstellung.

    Bei Berichten, die aus früheren Versionen von FoxPro übernommen werden, werden durch das Hinzufügen von ENVIRONMENT alle Tabellen und Beziehungen in der Datenumgebung geöffnet und wiederhergestellt, auch wenn AutoOpenTables auf Falsch (.F.) gesetzt ist.

    Beim Erstellen oder Ändern von Berichten können Sie die aktuelle Visual FoxPro-Datenumgebung zusammen mit der Berichtsdefinitionsdatei 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 Berichtsdefinitionsdatei aufgenommen.

  • Scope
    Gibt einen Bereich von Datensätzen an, die in den Bericht aufgenommen werden sollen. Nur die Datensätze innerhalb des Bereichs werden in den Bericht aufgenommen.

    Die Bereichsklauseln sind: ALL, NEXT nRecords, RECORD nRecordNumber und REST. Weitere Informationen zu Bereichsklauseln finden Sie unter Bereichsklauseln und Überblick über die Sprache.

    Der Standardbereich für REPORT ist ALL, das heißt alle Datensätze.

  • FOR lExpression1
    Gibt an, dass nur die Daten von Datensätzen gedruckt werden, für die lExpression1 gleich Wahr (.T.) ist. Wenn Sie FOR angeben, können Sie diejenigen Datensätze herausfiltern, die nicht gedruckt werden sollen.

    Rushmore optimiert REPORT FOR, wenn 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 Daten gedruckt werden, wie die Auswertung des logischen Ausdrucks lExpression2 Wahr (.T.) ergibt.

  • HEADING cHeadingText
    Gibt Text für eine zusätzliche Überschrift an, die auf jeder Seite des Berichts angezeigt werden soll. Die Klausel PLAIN hat Vorrang, wenn Sie sowohl HEADING als auch PLAIN verwenden.

  • NOCONSOLE
    Unterdrückt das Echo eines Berichts im Visual FoxPro-Hauptfenster oder einem benutzerdefinierten Fenster, wenn der Bericht gedruckt oder zu einer Datei geschickt wird.

  • NOOPTIMIZE
    Verhindert die Rushmore-Optimierung von REPORT.

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

  • PLAIN
    Gibt an, dass nur am Anfang des Berichts eine Seitenüberschrift angezeigt wird.

  • RANGE nStartPage [, nEndPage]
    Gibt einen Bereich von Seiten (Ausnahme: Seitenansicht) an, der gedruckt werden soll. nStartPage legt die erste und nEndPage legt die letzte Seite fest, die gedruckt wird. Wird nEndPage nicht angegeben, wird die letzte Seite, die gedruckt wird, standardmäßig auf 65.534 gesetzt.

  • PREVIEW [[IN] WINDOW WindowName | IN SCREEN]
    Zeigt den Bericht im Seitenansichtsmodus an, statt den Bericht an den Drucker zu schicken. Wenn ein Bericht auf dem Drucker ausgegeben werden soll, müssen Sie REPORT mit TO PRINTER eingeben.

    Systemvariablen werden ignoriert, wenn Sie PREVIEW verwenden.

    Sie können die optionale WINDOW- oder IN WINDOW-Klausel einbeziehen, um ein Fenster anzugeben, in dem der Bericht im Seitenansichtsmodus angezeigt wird. WindowName kann der Name eines mit DEFINE WINDOW erstellten Fensters sein. Wenn Sie die WINDOW-Klausel angeben, verwendet die Seitenansicht die Angaben (Titel, Größe usw.) des Fensters, das Sie mit WindowName angeben. Wenn Sie die IN WINDOW-Klausel angeben, wird die Seitenansicht des Berichts in dem Fenster angezeigt, das Sie in WindowName angegeben haben.

    Sie können die optionale IN SCREEN-Klausel einbeziehen, um anzugeben, dass das Seitenansichtsfenster für Berichte im Hauptfenster von Visual FoxPro enthalten ist und nicht aus demselben heraus bewegt werden kann.

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

    Stellen Sie in einer verteilten Anwendung sicher, dass das Menü Ansicht verfügbar ist. Wenn die Symbolleiste der Seitenansicht geschlossen ist, kann sie nur wiederhergestellt werden, wenn das Menü Ansicht verfügbar ist.

  • TO PRINTER [PROMPT]
    Schickt einen Bericht an den Drucker.

    In Visual FoxPro können Sie das optionale Argument PROMPT angeben, um vor dem Druckbeginn ein Dialogfeld zur Druckereinstellung anzuzeigen. Welche Druckereinstellungen Sie ändern können, hängt vom installierten Druckertreiber ab. Fügen Sie PROMPT direkt hinter TO PRINTER ein.

  • TO FILE FileName2 [ASCII]
    Gibt die Textdatei an, an die Sie den Bericht schicken möchten. Der aktuelle Druckertreiber wird verwendet, wenn der Bericht an die Textdatei gesendet wird. Die Datei, die angelegt wird, wenn Sie TO FILE verwenden, hat standardmäßig die Erweiterung TXT.

    Sie können die Klausel ASCII angeben, um aus der Berichtsdefinitionsdatei eine ASCII-Textdatei zu erstellen. Ohne die ASCII-Klausel werden PostScript- und andere Druckercodes in die Textdatei geschrieben. In der Berichtsdefinition enthaltene Grafiken, Linien, Rechtecke oder abgerundete Rechtecke werden nicht in die ASCII-Textdatei aufgenommen.

    Die Anzahl der Spalten und Zeilen auf jeder Seite der ASCII-Textdatei wird durch den Inhalt der Systemvariablen _ASCIICOLS und _ASCIIROWS festgelegt. Die Standardwerte für _ASCIICOLS und _ASCIIROWS sind 80 Spalten und 63 Zeilen. Diese Werte entsprechen einer Standardseite im Hochformat.

  • NAME ObjectName
    Gibt den Namen einer Objektvariablen für die Datenumgebung eines Berichts 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. Wenn Sie NAME nicht angeben, verwendet Visual FoxPro standardmäßig den Namen der Berichtsdatei, auf den im Code, der den Ereignissen zugeordnet ist, verwiesen werden kann.

  • SUMMARY
    Unterdrückt das Drucken der einzelnen Zeilen. Nur Summen und Zwischensummen werden gedruckt.

Hinweise

Die Standarderweiterung für eine Berichtsdefinitionsdatei ist FRX. Wenn die Berichtsdefinitionsdatei sich nicht im Standardverzeichnis befindet, muss ihr Pfad ebenfalls mit dem Dateinamen angegeben werden.

Siehe auch

_ASCIICOLS | _ASCIIROWS | CREATE REPORT | Datenumgebungsobjekt (DataEnvironment) | MODIFY REPORT