Service-Objekte
In diesem Thema werden wir uns die Service-Objekte ansehen.
"Bericht" Objekt
Dieses Objekt stellt einen Link zum aktuellen Bericht dar. Die Eigenschaften dieses Objekts können gesehen werden, wenn das Element “Bericht” im Fenster “Berichtbaum” ausgewählt wird.
Methoden:
|
Methode
|
Beschreibung
|
|
Funktion Calc
(const Expr: String): Variant
|
gibt den Wert von “Expr” zurück, das ist ein Ausdruck
zum Beispiel, Report.Calc('1+2') gibt “3” zurück
jede gültige fastReport-Ausdruck kann übergeben werden
im Parameter
|
|
Funktion GetDataSet
(const Alias: String): TfrxDataSet
|
gibt das Dataset mit dem angegebenen Namen zurück
das Dataset muss in der Dataset-Liste des Berichts erscheinen
(“Bericht> Daten...” Dialog)
|
"Engine" Objekt
Dies ist das nützlichste und interessanteste Objekt, es stellt einen Link zur Engine dar (der Kern von FastReport, der die Berichtserstellung verwaltet). Durch die Verwendung der Eigenschaften und Methoden der Engine können wirklich exotische Berichtsgestaltungslayouts erstellt werden
Die Methoden und Eigenschaften dieses Objekts.
|
Eigenschaft
|
Typ
|
Beschreibung
|
|
CurColumn
|
Integer
|
der Index der aktuellen Spalte in einem mehrspaltigen Bericht
ein Wert kann dieser Eigenschaft zugewiesen werden.
|
|
CurX
|
Erweitert
|
die aktuelle Druckposition auf der X-Achse
ein Wert kann dieser Eigenschaft zugewiesen werden.
|
|
CurY
|
Erweitert
|
die aktuelle Druckposition auf der Y-Achse
ein Wert kann dieser Eigenschaft zugewiesen werden.
|
|
DoublePass
|
Boolean
|
ist “Wahr”, wenn der Bericht ein Zwei-Durchlauf-Bericht ist
analog zu Report.EngineOptions.DoublePass.
|
|
FinalPass
|
Boolean
|
ist “Wahr”, wenn im letzten Durchlauf eines Zwei-Durchlauf-Berichts
|
|
PageHeight
|
Erweitert
|
Höhe des druckbaren Bereichs, in Pixeln
|
|
PageWidth
|
Erweitert
|
Breite des druckbaren Bereichs, in Pixeln
|
|
StartDate
|
TDateTime
|
Zeit der Berichtsausführung
das gleiche wie die <Date> Systemvariable
|
|
StartTime
|
TDateTime
|
Zeit der Berichtsausführung
das gleiche wie die <Time> Systemvariable
|
|
TotalPages
|
Integer
|
die Anzahl der Seiten in einem Bericht
das gleiche wie die <TotalPages> Systemvariable
der Bericht sollte ein Zwei-Durchlauf-Bericht sein, wenn diese Variable verwendet wird
|
|
SecondScriptcall
|
Boolean
|
Flag, das den 'Wiederholungsaufruf'-Status eines Ereignisses zurückgibt (in einigen Fällen
kann ein Ereignis während der Gruppierung wiederholt aufgerufen werden)
wenn Wahr, dann wurde das Skript bereits aufgerufen
|
Methoden:
|
Methode
|
Beschreibung
|
|
Prozedur AddAnchor
(const Text: String)
|
fügt “Text” zur Liste der Anker hinzu
siehe mehr unten
|
|
Prozedur NewColumn
|
erstellt eine neue Spalte in einem mehrspaltigen Bericht
nach der letzten Spalte wird automatisch ein Seitenumbruch
eingefügt
|
|
Prozedur NewPage
|
erstellt eine neue Seite (Seitenumbruch)
|
|
Prozedur ShowBand
(Band: TfrxBand)
|
zeigt ein Band mit einem angegebenen Namen an
nach der Anzeige des Bandes wird die “CurY”-Position
automatisch erhöht
|
|
Funktion FreeSpace: Erweitert
|
gibt die Höhe des verbleibenden weißen Raums auf der Seite in Pixeln zurück.
|
|
Funktion GetAnchorPage
(const Text: String): Integer
|
gibt die Seitenzahl zurück, auf der der angegebene Anker
platziert wurde
|
"Gliederung" Objekt
Dieses Objekt stellt das Steuerelement "Berichtbaum" in einem vorgestellten Bericht dar.
Die “Gliederung” zeigt eine baumartige Struktur des fertigen Berichts an. Wenn ein beliebiger Baumknoten angeklickt wird, springt das Vorschaufenster zur Seite, die diesen Knoten anzeigt. Um die “Gliederung” anzuzeigen, sollte sie entweder aktiviert werden, indem auf die 
Schaltfläche in der Symbolleiste des Vorschaufensters geklickt wird oder indem die Eigenschaft “Report.PreviewOptions.OutlineVisible” auf Wahr gesetzt wird. Die Breite der “Gliederung” in Pixeln kann dort ebenfalls festgelegt werden: “Report.PreviewOptions.OutlineWidth”.
Die Methoden der “Gliederung” sind:
|
Methode
|
Beschreibung
|
|
Prozedur AddItem
(const Text: String)
|
fügt ein Element mit dem Namen “Text” an der aktuellen Baumposition hinzu
die aktuelle Berichtseite und Position auf der Seite sind mit
dem Element verknüpft
|
|
Prozedur LevelRoot
|
verschiebt die aktuelle Position im Baum auf die Wurzelebene
|
|
Prozedur LevelUp
|
verschiebt die aktuelle Position im Baum um eine Ebene nach oben
|