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 DialogUserDialog 200,120

  Text 10,10,180,30,"Please push the Cancel button"

  OKButton 40,90,40,20

  CancelButton 110,90,60,20

  EndDialog

 

  Dim dlg As UserDialog
  Dialog dlg ' show dialog (wait for cancel)
  Debug.Print "Cancel was not pressed"
EndSub