Top
PowerCOBOL V11.0 Reference
FUJITSU Software

6.51 WillChangeRecord Event

Description:

Generated before one or more records (rows) in the ADO recordset object change.

Used in controls:

ADODataSource

Used in Objects:

None.

Parameters:

1. [VT_I4 - Index S9(9) COMP-5]

2. VT_I4 - adReason S9(9) COMP-5

3. VT_I4 - adStatus S9(9) COMP-5

4. VT_I4 - cRecords S9(9) COMP-5

5. VT_DISPATCH - pRecordset OBJECT REFERENCE POW-COBJECT

Description of parameters:

  1. Index: When the control is part of an array, Index contains the control's index in the array.

  2. adReason: Indicates the reason for this event as follows:
    POW-ADODB-ADRSNADDNEW: An operation will add a new record.
    POW-ADODB-ADRSNDELETE: An operation will delete a record.
    POW-ADODB-ADRSNUPDATE: An operation will update an existing record.
    POW-ADODB-ADRSNUNDOUPDATE: An operation will reverse the update of a record.
    POW-ADODB-ADRSNUNDOADDNEW: An operation will reverse the addition of a new record.
    POW-ADODB-ADRSNUNDODELETE: An operation will reverse the deletion of a record.
    POW-ADODB-ADRSNFIRSTCHANGE: An operation will make the first change to a record.

  3. adStatus: Indicates or requests the current status as follows:
    POW-ADODB-ADSTATUSCANCEL: Requests cancellation of the operation that caused the event to occur.
    POW-ADODB-ADSTATUSCANTDENY: Indicates that the operation cannot request cancellation of the pending operation.
    POW-ADODB-ADSTATUSOK: Indicates that the operation that caused the event was successful.
    POW-ADODB-ADSTATUSUNWANTEDEVENT: Requests that further events of the type that caused this event to be generated should not be generated.

  4. cRecords: Indicates the number of records changing.

  5. pRecordset: Indicates a pointer to the recordset object, for which this event is generated.

Details:

Consult the ADO documentation for details.