_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. The returned string is an empty string ("") if the user cancelled.

Syntax

result$ = _INPUTBOX$([title$][, message$][, defaultInput$])

Parameters

• title$ is an optional dialog box title
• message$ is an optional message or prompt that will is 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

• All parameters are optional
• Use message$ to specify instructions to the user
• If defaultInput$ is an empty string (""), then a password box is shown, and the input is masked
• The dialog box automatically becomes a modal window if the application window is visible

Availability

• QB64-PE v3.4.0 and up

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 if the user cancelled the input

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

• _NOTIFYPOPUP
• _MESSAGEBOX
• _MESSAGEBOX (function)
• _SELECTFOLDERDIALOG$
• _COLORCHOOSERDIALOG
• _OPENFILEDIALOG$
• _SAVEFILEDIALOG$

---

Navigation: Main Page with Articles and Tutorials Keyword Reference - Alphabetical Keyword Reference - By usage Report a broken link