Skip to main content

Cancel Property

Allows the OLE Button to become the Cancel Push Button for the current form so it will automatically respond whenever the end user presses the ESC key.

Definition​

Property "OLE.Cancel" as Boolean

Default: False

Remarks​

When the ESC key is pressed, an OnClick event is sent to the current SRP OLE Button control with the Cancel property set to 1. If a regular OpenInsight pushbutton control has the Cancel Push Button box checked it will be overridden by this property.

caution

Only one SRP OLE Button should have the Cancel property set to 1. Having more than one Cancel Push Button on the same form might cause unexpected behavior.

Example​

Equ True$ to 1
Equ False$ to 0

// Set the caption and accelerator for the Cancel button
Set_Property(@Window:".OLE_CANCEL_BUTTON", "OLE.Caption", "&Cancel")

// Set the button as the Cancel Push Button
Set_Property(@Window:".OLE_CANCEL_BUTTON", "OLE.Cancel", True$)

See Also​

Default, OnClick