Obiecte de serviciu
În acest subiect, vom analiza obiectele de serviciu.
Obiectul "Raport"
Acest obiect reprezintă un link către raportul curent. Proprietățile acestui obiect pot fi văzute atunci când se selectează elementul “Raport” în fereastra “Arbore raport”.
Metode:
|
Metodă
|
Descriere
|
|
funcția Calc
(const Expr: String): Variant
|
returnează valoarea lui “Expr”, care este o expresie
de exemplu, Report.Calc('1+2') returnează “3”
orice expresie validă fastReport poate fi trecută
în parametru
|
|
funcția GetDataSet
(const Alias: String): TfrxDataSet
|
returnează dataset-ul având numele specificat
dataset-ul trebuie să apară în lista de dataset-uri a raportului
(dialogul “Raport>Date...”)
|
Obiectul "Motor"
Acesta este cel mai util și interesant obiect, reprezintă un link către motor (nucleul FastReport, care gestionează construcția raportului). Folosind proprietățile și metodele motorului, pot fi create layout-uri de raport cu adevărat exotice
Metodele și proprietățile acestui obiect.
|
Proprietate
|
Tip
|
Descriere
|
|
CurColumn
|
Integer
|
indicele coloanei curente într-un raport cu mai multe coloane
o valoare poate fi atribuită acestei proprietăți.
|
|
CurX
|
Extended
|
poziția curentă de imprimare pe axa X
o valoare poate fi atribuită acestei proprietăți.
|
|
CurY
|
Extended
|
poziția curentă de imprimare pe axa Y
o valoare poate fi atribuită acestei proprietăți.
|
|
DoublePass
|
Boolean
|
egal cu “True” dacă raportul este unul cu două treceri
analog cu Report.EngineOptions.DoublePass.
|
|
FinalPass
|
Boolean
|
egal cu “True” când se află în ultima trecere a unui raport cu două treceri
|
|
PageHeight
|
Extended
|
înălțimea regiunii imprimabile, în pixeli
|
|
PageWidth
|
Extended
|
lățimea regiunii imprimabile, în pixeli
|
|
StartDate
|
TDateTime
|
timpul de rulare a raportului
același ca variabila de sistem <Date>
|
|
StartTime
|
TDateTime
|
timpul de rulare a raportului
același ca variabila de sistem <Time>
|
|
TotalPages
|
Integer
|
numărul de pagini dintr-un raport
același ca variabila de sistem <TotalPages>
raportul ar trebui să fie unul cu două treceri, dacă această variabilă este utilizată
|
|
SecondScriptcall
|
Boolean
|
flagrare returnând starea 'repeat-call' a unui eveniment (în unele cazuri
un eveniment poate fi apelat repetat în timpul grupării)
dacă True atunci scriptul a fost deja apelat
|
Metode:
|
Metodă
|
Descriere
|
|
procedura AddAnchor
(const Text: String)
|
adaugă “Text” la lista de ancore
vezi mai multe mai jos
|
|
procedura NewColumn
|
creează o nouă coloană într-un raport cu mai multe coloane
după ultima coloană, o întrerupere de pagină este automat
inserată
|
|
procedura NewPage
|
creează o nouă pagină (întrerupere de pagină)
|
|
procedura ShowBand
(Band: TfrxBand)
|
afișează o bandă cu un nume specificat
după afișarea benzii, poziția “CurY” este
incrementată automat
|
|
funcția FreeSpace: Extended
|
returnează înălțimea spațiului alb rămas pe pagină în pixeli.
|
|
funcția GetAnchorPage
(const Text: String): Integer
|
returnează numărul paginii unde ancorarea specificată
a fost plasată
|
Obiectul "Contur"
Acest obiect reprezintă elementul de control "Arbore raport" într-un raport previzualizat.
“Conturul” afișează o structură asemănătoare unui arbore a raportului finalizat. Când orice nod din arbore este apăsat, panoul de previzualizare sare la pagina care afișează acest nod. Pentru a afișa “Conturul”, acesta trebuie activat fie prin apăsarea 
butonului din bara de instrumente a ferestrei de previzualizare, fie prin setarea proprietății “Report.PreviewOptions.OutlineVisible” la True. Lățimea “Conturului” în pixeli poate fi setată acolo de asemenea: “Report.PreviewOptions.OutlineWidth”.
Metodele “Conturului” sunt:
|
Metodă
|
Descriere
|
|
procedura AddItem
(const Text: String)
|
adaugă un element având numele “Text” la poziția curentă din arbore
pagina curentă a raportului și poziția pe pagină sunt legate
de element
|
|
procedura LevelRoot
|
mută poziția curentă în arbore la nivelul rădăcină
|
|
procedura LevelUp
|
mută poziția curentă în arbore cu un nivel în sus
|