INPUTBOX( ) Function

Displays a modal dialog used by a parameterized view for input of a single string.

INPUTBOX(cInputPrompt [, cDialogCaption [, cDefaultValue [, nTimeout [,cTimeoutValue]]]])

Parameters

  • cInputPrompt
    Specifies the Prompt displayed above the text entry box.
  • cDialogCaption
    Specifies the text to display in the title bar of the dialog box.
  • cDefaultValue
    Specifies a default value to display in the text entry box.
  • nTimeout
    Specifies a timeout value in 1/1000 seconds.

cTimeoutValue

Specifies value to return if a timeout occurs.

Remarks

The dialog box displays an edit box and OK and Cancel buttons. The OK button always returns the contents of the text box. The Cancel button always returns an empty string. A timeout will return the specified text in cTimeoutValue or an empty string if cTimeoutValue is not passed.

Example

Y = "Nothing at all"
Y = INPUTBOX("TypeHere","Input ",Y,5000)
         && Displays dialog box for 5 seconds, 
         && then displays anything typed or "Nothing at all"

See Also

Input and Output | INPUT Command | MESSAGEBOX Function