FastReport Engine: Der Report-Erzeuger
Aus GEVITAS
Version vom 21. Dezember 2015, 18:40 Uhr von Gevitas (Diskussion | Beiträge)
1 Allgemeines
Die sog. FastReport-"Engine" ist der Kern von FastReport. Die Engine ist der Programmteil, der der report ausführt, also die Ausgabe erzeugt.
Die Enging stellt einige wichtige Funktionen und Variablen zur Verfügung, die man zur Ausführung von speziellen Aufgaben benutzen kann.
1.1 Eigenschaften
| Eigenschaft | Typ | Beschreibung |
|---|---|---|
| CurColumn | Integer | Der Index der aktuellen Spalte in einem mehrspaltigen Report. Dieser Eigenschaft kann auch ein Wert zugewiesen werden! |
| CurX | Extended | Die aktuelle Druck-Position in der X-Achse (horizontal) wird hier ausgegeben. Dieser Eigenschaft kann auch ein Wert zugewiesen werden! |
| CurY | Extended | Die aktuelle Druck-Position in der Y-Achse (vertikal) wird hier ausgegeben. Dieser Eigenschaft kann auch ein Wert zugewiesen werden! |
| DoublePass | Boolean | Enthält “True”, wenn der Report ein Zwei-Pass-Report ist, d.h. wenn die entsprechende Report-Option eingeschaltet ist. Ein Zwei-Pass-Report wird benötigt, wenn man...
...Summen aus dem Fuss im Kopf darstellen will ...die "Variable Seite x von n" verwendet will. In diesem Fall wird der Report zuerst komplett durchgerechnet und sozusagen im Stillen aufgebaut. Dann erst im zweiten Durchlauf wird der Report ausgegeben. Analog zu der Report-Option Report.EngineOptions.DoublePass. |
| FinalPass | Boolean | Enthält “True”, wenn der Report im zweiten Durchlauf fertig erstellt wurde. |
| PageHeight | Extended | Enthält die druckbare Höhe in Pixeln. |
| PageWidth | Extended | Enthält die druckbare Breite in Pixeln. |
| StartDate, StartTime | TDateTime | Datum/Zeit, in der der Report ausgeführt wird. Identisch mit der Variable <Date> bzw. |
| TotalPages | Integer | Die Anzahl der Seiten eines reports, identisch mit der Variablen < TotalPages>. Der Report muss ein Zwei-Pass-Report sein! |
| SecondScriptcall | Boolean | Dieser Wert gibt den 'Repeat-call'-Status eines Ereignisses zurück.
Wenn True wurde der Script schon einmal aufgerufen. |
1.2 Methoden
| Methode | Beschreibung |
|---|---|
| procedure AddAnchor
(const Text: String) |
adds “Text” to the list of anchors see more below |
| procedure NewColumn | creates a new column in a multi-column report. after the last column a page break is automatically inserted |
| procedure NewPage | creates a new page (page break) |
| procedure ShowBand
(Band: TfrxBand) |
displays a band with a specified name after displaying the band the “CurY” position is automatically incremented |
| function FreeSpace: Extended | returns height of the white space left on page in pixels. |
| function GetAnchorPage
(const Text: String): Integer |
returns the page number where the specified anchor has been placed |
