“Engine” object

Top  Previous  Next

This is the most useful and interesting object, it represents a link to the engine (FastReport’s core, which manages report construction). By using the engine’s properties and methods really exotic report design layouts can be created

 

The methods and properties of this object.

 

Property

Type

Description

CurColumn

Integer

the index of the current column in a multi-columned report

a value can be assigned to this property.

CurX

Extended

the current print position on the X-axis

a value can be assigned to this property.

CurY

Extended

the current print position on the Y-axis

a value can be assigned to this property.

DoublePass

Boolean

equals “True” if the report is a two-pass one

analogous to Report.EngineOptions.DoublePass.

FinalPass

Boolean

equals “True” when in last pass of a two-pass report

PageHeight

Extended

printable region’s height, in pixels

PageWidth

Extended

printable region’s width, in pixels

StartDate

TDateTime

time of report running

the same as the <Date> system variable

StartTime

TDateTime

time of report running

the same as the <Time> system variable

TotalPages

Integer

the number of pages in a report

the same as the < TotalPages> system variable

the report should be a two-pass one, if this variable is used

SecondScriptcall

Boolean

flag  returning  'repeat-call' status of an event (in some cases

an event can be called repeatedly during grouping)

if  True then the script  has already been called

 

Methods:

 

Method

Description

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