Requires AutoHotkey v1.1+ or v2.0-a053+

License: WTFPL

output := EntryForm( form, fields* )

out := {
    "event":  [ OK, Cancel, Close, Escape, Timeout ], // [string] either of these
    "output": [ field1, field2, ... ] // array containing the output of each input field
}

Remarks:

• If the EntryForm has only one(1) field, .output will contain a string, the value itself

form [-cap | -c <caption>] [-fnt | -f <fontspec>] [-ico | -i <iconspec>] [-t <period>]
     [-F <callback>] [-pos | -p <position>] [-opt | -o <options>]

A space-delimited string containing one or more of the following below. Options are passed in command line-like syntax. Note: if an argument contains a space, it must be enclosed in single quotes. Multiple arguments are separated by a comma:

Remarks:

• Window height must not be specified, it is calculated automatically based on the total number of input fields
• For -ico, the same icon will be used for the window caption (small) and the Alt+Tab switcher (large)
• If a callback function is defined (via -F option), the function will return immediately instead of waiting for the window to close. Function must require atleast one(1) parameter. However, if a -t (timeout) is defined, callback function is ignored

Example Usage:

/* If window position is not specified, it is shown in the center
 * The '-fnt' option applies to fields(controls) whose '-fnt' option is not specified
 */
form := "-c 'Test Form' -ico 'cmd.exe,0' -fnt 's10 cBlue,Consolas' T5000 w500 +ToolWindow"
/* Optional syntax for timeout, pos and options
 * form := "-t 5000 -pos 'x0 w500' -o '+ToolWindow -Caption'"
 */
output := EntryForm(form, ...)

field (-p <prompt>) [-d <default>] [-fnt <fontspec>] [-in <input_ctrl>] [-cb <cuebanner>]
      [-tt <tooltip>] [-ud <updown>] [-fs <fileselect>] [-ds <dirselect>] [-opt | -o <options>]

A space-delimited string containing one or more of the following below. Options are passed in command line-like syntax. Note: if an argument contains a space, it must be enclosed in single quotes. Multiple arguments are separated by a comma:

Remarks:

• For -fs and -ds, order of the arguments is the same as in their counterpart AHK commands
• Input field width must not be specified, it is calculated automatically based on the EntryForm window width as specified in form parameter
• For -fs and -ds, if the button's associated Edit control is NOT empty, a SplitPath will be performed on the text(contents), OutDir will be used as the initial directory and OutFileName will be used as the initial file name (latter applies to -fs) when the dialog is shown.
• If input field control type is not an Edit control, the following options are ignored: -cb, -ud, -fs, -ds

Example Usage:

/* For options which require arguments to be enclosed in single quotes, to specify a literal
 * single quote, escape it with a backslash '\'
 */
field1 := "-p 'Enter your password:' -fnt 'Italic,Segoe UI' -cb 'Password here' R1 Password"

/* For '-fs' option, separate each argument with a comma, order of arguments is the same as
 * FileSelectFile command: [ Options, RootDir\Filename, Prompt, Filter ]
 */
field2 := "-p 'File to upload:' -fs '1,C:\Dir,Select a file,Text Document (*.txt; *.tex)'"

out := EntryForm(form, field1, field2)

• Behavior is similar to that of the InputBox command, that is the script will be in a waiting state while the EntryForm window is shown. To bypass this, the caller can use a timer or define a callback function using the -F option - see Form options above.