Cancel Property [Access 2003 VBA Language Reference]

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 OnClickevent 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

CancelDefault

Applies to | CommandButton Object | CustomControl Object

See Also | Click Event | Default Property