Cancel Property

Microsoft Access Visual Basic

Cancel Property

       

You can use the Cancel property to specify whether a command button is also the Cancel button on a form. Read/write Boolean.

expression.Cancel

expression   Required. An expression that returns one of the objects in the Applies To list.

Setting

The Cancel property uses the following settings.

Setting Visual Basic Description
Yes True The command button is the Cancel button.
No False (Default) The command button isn't the Cancel button.

You can set this property by using the command button's property sheet, a macro, or Visual Basic.

Remarks

Setting the Cancel property to Yes makes the command button the Cancel button in the form. However, you must still write the macro or Visual Basic event procedure that performs whatever action or actions you want the Cancel button to carry out (for example, closing the form without saving any changes to it). Set the command button's OnClick event property to the name of the macro or event procedure.

When a command button's Cancel property setting is Yes and the Form window is active, the user can choose the command button by pressing ESC, by pressing ENTER when the command button has the focus, or by clicking the command button.

Note   If a text box has the focus when the user presses ESC, any changes made to the data in the text box will be lost, and the original data will be restored.

When the Cancel property is set to Yes for one command button on a form, it is automatically set to No for all other command buttons on the form.

Tip   For a form that supports irreversible operations, such as deletions, it's a good idea to make the Cancel button the default command button. To do this, set both the Cancel property and the Default property to Yes.