_INPUTBOX$

From QB64 Phoenix Edition Wiki
Jump to navigation Jump to search

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



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