Rave Reports Developer Reference

TRvCustomConnection

Unit

               RpCon

Hierarchy

Description

Through the events in the data connection components, you can customize how the data is sent to your Rave reports. For non-database data using the TRvCustomConnection component, you will need to provide all access to your data through these events. For database data connection components such as TRvDataSetConnection, you will normally only want to override the OnValidateRow event.

NOTE:

The TRvCustomConnection component has a DataIndex and DataRows property of type integer. These are provided for use by custom connector events and if used, can alleviate the need to define the OnFirst, OnNext and OnEOF events. DataIndex is intended to be used as the data cursor position with 0 representing the first row. DataRows is intended to be used as the row count of the data. For example, if you were defining a custom data connection for a memory array, you would only need to initialize the Connection.DataRows property to the number of elements in the memory array and then let Rave handle the OnFirst, OnNext and OnEOF events. In the OnGetRow event you would then access the Connection. DataIndex property to determine which array element to pass back (remember that DataIndex is 0 for the first row).

Properties from TRvCustomConnection

FieldAliasList LocalFilter RuntimeVisibility

Properties from TRpComponent

Version

Methods from TRvCustomConnection

WriteBCDData WriteBlobData WriteBoolData WriteCurrData WriteDateTime WriteFloatData WriteIntData WriteNullData WriteStrData

Events from TRvCustomConnection

OnEOF OnFirst OnGetCols OnGetRow OnGetSorts OnNext OnOpen OnRestore OnSetFilter OnSetSort OnValidateRow