WillChangeField イベントは、保留中の操作で、Recordset の 1 つ以上の Field オブジェクトの値が変更される前に呼び出されます。FieldChangeComplete イベントは、1 つ以上の Field オブジェクトの値が変更された後に呼び出されます。
構文
WillChangeField cFields, Fields, adStatus, pRecordset
FieldChangeComplete cFields, Fields, pError, adStatus, pRecordset
パラメータ
cFields Fields 内の Field オブジェクトの数を表す長整数型 (Long) の値です。
Fields 保留中の変更と共に Field オブジェクトを格納する Variants の配列です。
pError Error オブジェクトです。adStatus の値が adStatusErrorsOccurred の場合に発生するエラーを示します。これ以外の場合は設定されません。
adStatus EventStatusEnum ステータス値です。
WillChangeField が呼び出されたとき、イベントを発生した操作が成功した場合、このパラメータは adStatusOK に設定されます。保留中の操作の取り消しをこのイベントが要求できない場合、このパラメータは adStatusCantDeny に設定されます。
FieldChangeComplete が呼び出されたとき、このパラメータは、イベントを発生した操作が成功した場合は adStatusOK、失敗した場合は adStatusErrorsOccurred に設定されます。
WillChangeField から返る前に保留中の操作の取り消しを要求するには、このパラメータを adStatusCancel に設定します。
FieldChangeComplete から返る前に後続の通知が実行されるのを防ぐには、このパラメータを adStatusUnwantedEvent に設定します。
pRecordset Recordset オブジェクトです。このイベントによって発生した Recordset です。
解説
WillChangeField イベントまたは FieldChangeComplete イベントは、Value プロパティを設定し、フィールドと値配列パラメータと共に Update メソッドを呼び出すとき発生します。