cancel

Type: Boolean

Availability: Read or write at any time

The cancel property applies to Button and JadeMask controls. If the cancel property is set to true, that button or mask control is marked as the Cancel button. Assign this status to a button marked Cancel. (Pressing Esc has the same effect as pressing the Cancel button or mask control.)

If the form has a Button control with the cancel property set to true and an open combo box has focus, the Esc key is processed by the combo box; not by the Cancel button. The Cancel button action occurs only if the combo box list is not open.

When the user presses Esc, if there is an enabled visible button or mask control with the cancel property set to true on the same form, the focus is transferred to that button or JADE mask control and a click event is caused on the button or mask control, regardless of which control on the form had the focus. The default value is false.

It is your responsibility to ensure that only one button or JADE mask control on a form has the cancel property set to true. If not, the first such enabled visible button or mask control that is encountered with that status receives the event. You must write logic to respond to the event.