BeforeBand Event

Occurs just before the Report System begins processing a report band.

PROCEDURE Object.BeforeBand
LPARAMETERS nBandObjCode, nFRXRecNo

Parameters

Visual FoxPro passes the BeforeBand event parameters in the following order:

  • nBandObjCode
    Integer data type, specifying the type of band, as stored in the ObjCode field of the report or label definition file (frx or lbx).

    Recognized numeric values for nBandObjCode are documented in the 60FRX.DBF table in the FILESPEC directory, as follows:

    0

    Title

    1

    Page Header

    2

    Column Header

    3

    Group Header

    4

    Detail

    5

    Group Footer

    6

    Column Footer

    7

    Page Footer

    8

    Summary

    9

    Detail Header

    10

    Detail Footer

    For more information about 60FRX, see Table Structures of Table Files (.dbc, .frx, .lbx, .mnx, .pjx, .scx, .vcx).

  • nFRXRecno
    Integer data type, specifying the record number in the report or label definition file (frx or lbx) describing the layout element being rendered.

Remarks

Applies To: ReportListener Object.

For each band in the report, the ReportListener triggers the BeforeBand event before the Report Engine runs any code in the OnEntry expression. It triggers the AfterBand event after any OnExit code runs.

Note

For information about the order of events in a report run, see Understanding Visual FoxPro Object-Assisted Reporting.

See Also

Tasks

How to: Specify Expressions to Evaluate When Processing Bands

Reference

ReportListener Object

AfterBand Event

Other Resources

Events (Visual FoxPro)

Language Reference (Visual FoxPro)