DoCmd.CancelEvent メソッド (Access)

CancelEvent メソッドは、Visual Basic で CancelEvent アクションを実行します。

構文

式。CancelEvent

expression: DoCmd オブジェクトを表す変数。

注釈

CancelEvent メソッドを使用して、Microsoft Access がこのメソッドを含むプロシージャを実行する原因となったイベントを取り消します。

CancelEvent メソッドは、イベントによって実行されたときにのみ有効です。 このメソッドはイベントをキャンセルします。

フォームでは、入力検査マクロに "CancelEvent/イベントのキャンセル" アクションを定義し、"BeforeUpdate/更新前処理" イベント プロパティと組み合わせて使用する方法が一般的です。 ユーザーがコントロールまたはレコードにデータを入力したとき、入力データがデータベースに追加される前に入力検査マクロが実行されます。 データがマクロの入力検査の条件に適合しない場合は、"CancelEvent/イベントのキャンセル" アクションにより、更新処理がキャンセルされます。

Visual Basic で取り消すことができるすべてのイベントには 、Cancel 引数があります。 イベントを取り消すには、CancelEvent メソッドの代わりにこの引数を使用します。 KeyPress イベントと MouseDown イベント (右クリックのみ) は、イベント プロシージャではなくマクロでのみ取り消すことができるので、これらのイベントを取り消すには、マクロで CancelEvent アクションを使用する必要があります。

注:

オブジェクトを右クリックしたときに発生するイベントを取り消すには、MouseDown イベントでのみ CancelEvent メソッドを使用します。

キャンセル可能なイベントでは、イベントのプロシージャが実行された後に、イベントの既定の動作 (イベント発生時の通常の動作) が実行されます。 したがって、既定の動作を取り消すことができます。 たとえば、テキスト ボックスのカーソル位置の単語をダブルクリックすると、通常は、その単語が選択されます。 DblClick イベントのプロシージャで、この既定の動作を取り消し、テキスト ボックスのデータに関する情報を表示するフォームを開くなどの別のアクションを実行することができます。 取り消すことができないイベントでは、イベントのプロシージャが実行される前に、既定の動作が実行されます。

サポートとフィードバック

Office VBA またはこの説明書に関するご質問やフィードバックがありますか？ サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。