_INPUTBOX$
Jump to navigation
Jump to search
Navigation:
Main Page with Articles and Tutorials
Keyword Reference - Alphabetical
Keyword Reference - By usage
Report a broken link
The _INPUTBOX$ function displays a prompt in a dialog box, waits for the user to input text or click a button, and returns a string containing the contents of the text box.
Syntax
- result$ = _INPUTBOX$([title$][, message$][, defaultInput$])
Parameters
- title$ is an optional dialog box title.
- message$ is an optional message or prompt that will be displayed in the dialog box.
- defaultInput$ is an optional string that is displayed in the text box as the default response if no other input is provided.
Description
- Use message$ to specify instructions to the user.
- All parameters are optional, hence omitting defaultInput$ will display a empty text box.
- However, if defaultInput$ is provided, but is an empty string (""), then a password box is shown, and the text input will be masked.
- The result$ may be an empty string (""), if the user simply cancelled the dialog.
- The dialog box automatically becomes a modal window, if the application window is visible.
Availability
Examples
- Example 1
- Hello world, with common dialogs.
username$ = _INPUTBOX$("Hello App", "Enter your name:", "anonymous") _MESSAGEBOX "Hello App", "Hello " + username$, "info" |
- Example 2
- Checking whether the user cancelled the input dialog.
age$ = _TRIM$(_INPUTBOX$(, "Enter your age:")) IF LEN(age$) = 0 THEN _MESSAGEBOX , "Cancelled." ELSE _MESSAGEBOX , "Age = " + age$ END IF |
- Example 3
- Getting passwords.
password$ = _INPUTBOX$("Login", "Enter password:", "") IF LEN(password$) = 0 THEN _MESSAGEBOX , "Cancelled." ELSE _MESSAGEBOX , "You entered = " + password$ END IF |
See also
- _MESSAGEBOX, _MESSAGEBOX (function)
- _NOTIFYPOPUP, _COLORCHOOSERDIALOG
- _SELECTFOLDERDIALOG$, _OPENFILEDIALOG$, _SAVEFILEDIALOG$