WillChangeField イベントと FieldChangeComplete イベント (ADO)

適用先: Access 2013、Office 2013

WillChangeField イベントは、保留中の操作で Recordset 内の 1 つ以上の Field オブジェクトの値が変更される前に呼び出されます。 FieldChangeComplete イベントは、1 つ以上の Field オブジェクトの値が変更された後に呼び出されます。

構文

WillChangeFieldcFields、 Fields、 adStatus、 pRecordset

FieldChangeCompletecFields、 Fields、 pError、 adStatus、 pRecordset

パラメーター

パラメーター	説明
cFields	Fields 内の Field オブジェクトの数を表す長整数型 (Long) の値です。
フィールド	WillChangeField の場合、Fields パラメーターは、元の値と共に Field オブジェクトが格納されたバリアント型 (Variant) の配列です。 FieldChangeComplete の場合、Fields パラメーターは、変更後の値と共に Field オブジェクトが格納されたバリアント型 (Variant) の配列です。
Perror	Error オブジェクトです。 adStatus の値が adStatusErrorsOccurred である場合に発生したエラーについて説明します。それ以外の場合は設定されません。
adStatus	EventStatusEnum。 WillChangeField が呼び出されたとき、イベントを発生させた操作が成功した場合、このパラメーターは adStatusOK に設定されます。 保留中の操作の取り消しをこのイベントが要求できない場合、このパラメーターは adStatusCantDeny に設定されます。 FieldChangeComplete が呼び出されたとき、このパラメーターは、イベントを発生させた操作が成功した場合は adStatusOK 、失敗した場合は adStatusErrorsOccurred に設定されます。 WillChangeField から制御が戻る前に保留中の操作の取り消しを要求する場合は、このパラメーターを adStatusCancel に設定します。 FieldChangeComplete から制御が戻る前に後続の通知が行われるのを防ぐには、このパラメーターを adStatusUnwantedEvent に設定します。
pRecordset	Recordset オブジェクト。 このイベントが発生した Recordset オブジェクトです。

注釈

WillChangeField イベントまたは FieldChangeComplete イベントは、Value プロパティを設定し、フィールドと値配列パラメーターを指定して Update メソッドを呼び出したときに発生します。