_INPUTBOX$

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

• 

  none

• 

  v3.4.0

• 
• 

  yes

• 

  yes

• 

  yes

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$

---

Navigation: Main Page with Articles and Tutorials Keyword Reference - Alphabetical Keyword Reference - By usage