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.)

Parameter Description

X This number value is the distance from the left edge of the dialog box. It is measured in 1/8 ths of the average character width for the dialog's font.

Y This number value is the distance from the top edge of the dialog box. It is measured in 1/12 ths of the character height for the dialog's font.

DX This number value is the width. It is measured in 1/8 ths of the average character width for the dialog's font.

DY This number value is the height. It is measured in 1/12 ths of the character height for the dialog's font.

Field This identifier is the name of the field. The dialogfunc receives this name as string. If this is omitted then the field name is "Cancel".

See Also: Begin Dialog, Dim As UserDialog.

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