InputBox()
OutputVar := Mfunc.InputBox([Title, Prompt, HIDE, Width, Height, X, Y, Font, Timeout, Default])
Displays an input box to ask the user to enter a string.
Title
The title of the input box. If blank or omitted, it defaults to the name of the script.
Can be MfString instance or var containing string.
Prompt
The text of the input box, which is usually a message to the user indicating what kind of input is expected. If Prompt is long, it can be broken up into several shorter lines by means of a continuation section, which might improve readability and maintainability.
Can be MfString instance or var containing string.
HIDE
If this parameter is the word HIDE, the user's input will be masked, which is useful for passwords. This Parameter and true or false. Can be an instance of MfBool or can be instance of MfString containing a value of "HIDE" or a var.
Width
If this parameter is blank or omitted, the starting width of the window will be 375. This parameter can be an expressions.
Can be MfInteger instance or var containing integer.
Height
If this parameter is blank or omitted, the starting height of the window will be 189. This parameter can be an expression.
Can be MfInteger instance or var containing integer.
X, Y
The X and Y coordinates of the window (use 0,0 to move it to the upper left corner of the desktop), which can be expressions.. If either coordinate is blank or omitted, the dialog will be centered in that dimension. Either coordinate can be negative to position the window partially or entirely off the desktop.
Can be MfInteger instance or var containing integer.
Font
Not yet implemented (leave blank). In the future it might accept something like verdana:8
Can be MfString instance or var containing string.
Timeout
Timeout in seconds (can contain a decimal point or be an expressions.). If this value exceeds 2147483 (24.8 days), it will be set to 2147483. After the timeout has elapsed, the InputBox window will be automatically closed and ErrorLevel will be set to 2. OutputVar will still be set to what the user entered.
Can be MfFloat instance or var containing float.
Default
A string that will appear in the InputBox's edit field when the dialog first appears. The user can change it by backspacing or other means.
Can be MfString instance or var containing string.
Returns the text entered by the user.
Throws MfException throw any errors with InnerException set to the Autohotkey - InputBox error message.
Wrapper for AutoHotkey Docs - InputBox.
Static method.
The dialog allows the user to enter text and then press OK or CANCEL. The user can resize the dialog window by dragging its borders.
ErrorLevel is set to 1 if the user presses the CANCEL button, 0 if the user presses OK, or 2 if the dialog times out. In all three cases, Return is set to the value entered. This allows the CANCEL button to perform a function other than CANCEL should the script designer wish it.
A GUI window may display a modal InputBox by means of Gui +OwnDialogs. A modal InputBox prevents the user from interacting with the GUI window until the InputBox is dismissed.
See Also:AutoHotkey Docs - InputBox.
password := Mfunc.InputBox("Enter Password", "(your input will be hidden)", "hide")
UserInput := Mfunc.InputBox("Phone Number", "Please enter a phone number.", , 640, 480)
if ErrorLevel
MsgBox, CANCEL was pressed.
else
MsgBox, You entered "%UserInput%"