CancelButton Dialog Item Definition

Syntax

CancelButton X, Y, DX, DY[, .Field]

Group

User Dialog

Description

Define a cancel button item. Pressing the Cancel button from a Dialog instruction causes a run-time error. (Dialog( ) function call returns 0.)

Parameters

Parameters	Description
X	The distance from the left edge of the dialog. It is measured in 1/8ths of the average character width for the dialog font.
Y	The distance from the top edge of the dialog. It is measured in 1/12ths of the character height for the dialog font.
DX	The width. It is measured in 1/8ths of the average character width for the dialog font.
DY	The height. It is measured in 1/12ths of the character height for the dialog font.
Field	The name of the field. The dialogfunc receives this name as string. If this is omitted, the field name is Cancel.

Example

---

Sub Main
    Begin Dialog UserDialog 200,120
        Text 10,10,180,30,"Please push the Cancel button"
        OKButton 40,90,40,20
        CancelButton 110,90,60,20
    End Dialog
    Dim dlg As UserDialog
    Dialog dlg ' show dialog (wait for cancel)
    Debug.Print "Cancel was not pressed"
End Sub

See also

Begin Dialog