|
|
+
|
CHARACTER AfterFill
|
This event occurs at the very end of a FILL, and can be used to
adjust the contents of the ProDataSet object or Buffer object, reject
the FILL operation, or disconnect from a server or database. For a
child table, the event occurs once for each parent record that is
created.
|
|
|
+
|
CHARACTER AfterRowFill
|
This event occurs after a record is created in the temp-table. The
procedure can, for example, modify field values in the record by
supplying values for calculated fields, or perform filtering and
reject a record by deleting it. The procedure cannot modify record
currency using the ProDataSet object buffers in any other way. It
can use separately defined buffers to modify the ProDataSet object
in other ways. The procedure can RETURN ERROR to abort the entire
FILL, or RETURN NO-APPLY to cancel the cascading of the FILL to
child buffers, if any.
|
|
|
+
|
CHARACTER BeforeFill
|
This event occurs at the very beginning of a FILL, before anything
is read or created.
|
|
|
+
|
CHARACTER BeforeRowFill
|
This event occurs before a record is created in the temp-table, but
after the data source record(s) for it are read. For example, this
procedure could examine the database buffers or other information
and decide not to create the record, using a RETURN NO-APPLY statement.
|
|
|
+
|
CHARACTER RowCreate
|
This event occurs immediately after the record is created in the
temp-table. The current buffer for the temp-table is available and
contains initial values as defined in the temp-table definition
(or inherited from the schema). You can use this event to calculate
initial values for fields, make changes to other records, or reject
the creation by deleting the new temp-table record.
|
|
|
+
|
CHARACTER RowDelete
|
This event occurs when you delete a temp-table record, immediately
before the record is deleted. The event procedure can use this event
to RETURN ERROR to cancel the delete, or to make adjustments to
other records based on the delete. Since the record has not yet been
deleted, the record is in the temp-table buffer and the code can
look at its values. Because the code can assume that the DELETE will
go through unless cancelled by the event procedure itself, it can
take actions based on the record deletion while the record is still
there to be looked at.
|
|
|
+
|
CHARACTER RowUpdate
|
This event occurs immediately before the record is updated in the
temp-table. It typically occurs when:
- The buffer scope ends
- The transaction scope ends
- The RELEASE statement or BUFFER-RELEASE() method is run on the buffer
- The buffer is needed for another record
|
