Contents
- Index
Form (function)
Form(sForm,sOptions) : String
Display a GUI form in a macro
sForm - The code that makes up the form to display
sOptions - Provided for future enhancements. Currently you should just enter as "".
Use the string return value of Form() to determine how the user exits the form. Possible values:
SystemExit - The user clicked on the Red X button at the top of the form
DelayExit - The form used a "Delay" property, and the delay timer reached zero without any user intervention
Control Name - The name of the control that caused the form to exit.
This is probably best illustrated by a simple macro that uses the form function:
While True # Infinite loop to redisplay form as required
$FormExit = form($form,"")
BeginCase
Case $FormExit = "DelayExit"
MsgOk msg="Form exit via Delay"
break
Case $FormExit = "SystemExit"
MsgOk msg="Form exit via red X button on form"
break
Case $FormExit = "btnCancel"
MsgOk msg="Form exit from the cancel button"
break
Case $FormExit = "btnOk"
msgOk msg="We clicked on the OK button, form will redisplay"
# perform OK calcs here, then because we do not have a BREAK the form will redisplay
EndCase
EndWhile
<Data> VarName=$form
#********************************************************************
# Form generated by GSAK form designer on Sat 01-Sep-2007 16:26:20
#********************************************************************
Name = Form1
Type = Form
Delay = 10
Height = 137
Width = 287
Name = btnOk
Type = Button
Height = 25
Left = 32
Top = 40
Width = 75
Caption = OK
Name = btnCancel
Type = Button
Height = 25
Left = 152
Top = 40
Width = 75
Caption = Cancel
<enddata> |
Related: EditForm()
Alpha List Category List
|