FastReport Engine: Der Report-Erzeuger: Unterschied zwischen den Versionen
Aus GEVITAS
(Die Seite wurde neu angelegt: „== Allgemeines == Die sog. FastReport-"Engine" ist der Kern von FastReport. Die Engine ist der Programmteil, der der report ausführt, also die Ausgabe erzeug…“) |
|||
| Zeile 15: | Zeile 15: | ||
|CurColumn | |CurColumn | ||
|Integer | |Integer | ||
| − | | | + | |Der Index der aktuellen Spalte in einem mehrspaltigen Report. Dieser Eigenschaft kann auch ein Wert zugewiesen werden! |
| − | |||
|- valign="top" | |- valign="top" | ||
|CurX | |CurX | ||
|Extended | |Extended | ||
| − | | | + | |Die aktuelle Druck-Position in der X-Achse (horizontal) wird hier ausgegeben. Dieser Eigenschaft kann auch ein Wert zugewiesen werden! |
| − | |||
|- valign="top" | |- valign="top" | ||
|CurY | |CurY | ||
|Extended | |Extended | ||
| − | | | + | |Die aktuelle Druck-Position in der Y-Achse (vertikal) wird hier ausgegeben. Dieser Eigenschaft kann auch ein Wert zugewiesen werden! |
| − | |||
|- valign="top" | |- valign="top" | ||
|DoublePass | |DoublePass | ||
|Boolean | |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. | ||
|- valign="top" | |- valign="top" | ||
|FinalPass | |FinalPass | ||
|Boolean | |Boolean | ||
| − | | | + | |Enthält “True”, wenn der Report im zweiten Durchlauf fertig erstellt wurde. |
|- valign="top" | |- valign="top" | ||
|PageHeight | |PageHeight | ||
|Extended | |Extended | ||
| − | | | + | |Enthält die druckbare Höhe in Pixeln. |
|- valign="top" | |- valign="top" | ||
|PageWidth | |PageWidth | ||
|Extended | |Extended | ||
| − | | | + | |Enthält die druckbare Breite in Pixeln. |
|- valign="top" | |- valign="top" | ||
|StartDate, StartTime | |StartDate, StartTime | ||
|TDateTime | |TDateTime | ||
| − | | | + | |Datum/Zeit, in der der Report ausgeführt wird. Identisch mit der Variable <Date> bzw. <Time>. |
|- valign="top" | |- valign="top" | ||
|TotalPages | |TotalPages | ||
|Integer | |Integer | ||
| − | | | + | |Die Anzahl der Seiten eines reports, identisch mit der Variablen < TotalPages>. Der Report muss ein Zwei-Pass-Report sein! |
|- valign="top" | |- valign="top" | ||
|SecondScriptcall | |SecondScriptcall | ||
|Boolean | |Boolean | ||
| − | | | + | |Dieser Wert gibt den 'Repeat-call'-Status eines Ereignisses zurück. |
| + | Wenn '''True''' wurde der Script schon einmal aufgerufen. | ||
|- valign="top" | |- valign="top" | ||
| − | |||
| | | | ||
| | | | ||
|} | |} | ||
| + | === Methoden === | ||
| − | + | {| class="wikitable" style="text-align: left;" | |
| − | + | !Methode | |
| − | + | !Beschreibung | |
| − | + | |- valign="top" | |
| − | + | |procedure AddAnchor | |
| − | |||
| − | |||
| − | |||
| − | procedure AddAnchor | ||
(const Text: String) | (const Text: String) | ||
| − | adds “Text” to the list of anchors | + | |adds “Text” to the list of anchors see more below |
| − | see more below | + | |- valign="top" |
| − | procedure NewColumn | + | |procedure NewColumn |
| − | creates a new column in a multi-column report | + | |creates a new column in a multi-column report. after the last column a page break is automatically inserted |
| − | after the last column a page break is automatically | + | |- valign="top" |
| − | + | |procedure NewPage | |
| − | procedure NewPage | + | |creates a new page (page break) |
| − | creates a new page (page break) | + | |- valign="top" |
| − | procedure ShowBand | + | |procedure ShowBand |
(Band: TfrxBand) | (Band: TfrxBand) | ||
| − | displays a band with a specified name | + | |displays a band with a specified name after displaying the band the “CurY” position is automatically incremented |
| − | after displaying the band the “CurY” position is | + | |- valign="top" |
| − | automatically incremented | + | |function FreeSpace: Extended |
| − | function FreeSpace: Extended | + | |returns height of the white space left on page in pixels. |
| − | returns height of the white space left on page in pixels. | + | |- valign="top" |
| − | function GetAnchorPage | + | |function GetAnchorPage |
(const Text: String): Integer | (const Text: String): Integer | ||
| − | returns the page number where the specified anchor | + | |returns the page number where the specified anchor has been placed |
| − | has been placed | + | |- valign="top" |
| + | | | ||
| + | | | ||
| + | |- valign="top" | ||
| + | | | ||
| + | | | ||
| + | |} | ||
Version vom 21. Dezember 2015, 18:40 Uhr
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 |
