GSAK (Geocaching Swiss Army Knife)
 

Contents - Index


Input (command)

INPUT <Msg="message"> [<Default="">] [<VarName=$Result>] [<Browse=None|Folder|File>] [<Delay=nnn>]

Msg = The message to display when the input dialog shows
Default = The default value that will be assigned to VarName if nothing is entered (optional, default is blank)
VarName = The Macro variable that will contain the data entered (optional, default is $Result)
Browse = Folder - use when the input dialog is asking for a Folder path. This will add a Folder browse button to the dialog so you can use the windows GUI to select the folder. File - use when the input dialog is asking for a File name. This will add a File browse button to the dialog so you can use the windows GUI to select the file name. This token is optional and the default is None
Delay - Allows the dialog to automatically close after nnn seconds. This will allow you to run macros unattended and accept default values if you are not there to enter anything. The left most section of the dialog caption will show a count down timer with the number of seconds ticking over before the dialog will close. If you want to stop the dialog from closing, any mouse click on the dialog will terminate the count down timer. This effectively enables you to convert the form on the fly to a normal dialog (without automatic close) if you do want to enter data.

The INPUT command allows you to get information from the user while the macro is running and place the result in a variable.
The optional Default token allows you to specify a value that will show in the input field in the prompt. $Result is the default variable name (automatically allocated if you leave off this token) but you can declare any variable name here.

If you need more information from the user see the Form() function.

Related: Form() Choose YesNo()

Alpha List         Category List


Copyright 2004-2011 CWE Computer Services  
Privacy Policy Contact