Developer Documentation Library > Scripting > UNICOM Intelligence Function Library > Miscellaneous functions > InputBox
 
InputBox
Displays a dialog containing a specified message, a text box for input, an OK button, and a Cancel button.
Syntax
InputBox(Prompt[, Default[, Title]])
Parameters
Prompt
Type: Text
Message to display in the dialog.
Default
Type: Text
Optional. Initial contents of the dialog.
Title
Type: Text
Optional. Text to display in the title bar.
(return)
Type: Text
Final contents of the text box, or an empty string.
Remarks
The user can change the contents of the text box. If the user clicks OK or presses Enter, the current contents of the text box are returned. If the user clicks Cancel or presses Escape, the return value is "". If Default is omitted, the text box is initially empty. If Title is omitted or is "", the dialog's title is “UNICOM Intelligence”.
The dialog's height is adjusted (up to the height of the screen) to include as much as possible of the Prompt text. All text entered in the text box is returned. This is different from the Visual Basic InputBox, which displays only 1023 characters of the prompt, allows only 1023 characters of input, and returns only 254 of the input characters.
The dialog is modal, meaning that the InputBox function does not return until the user closes it, for example, by clicking OK or Cancel. However, if the dialog is being called from a Windows application, the application is not suspended while the dialog is open.
See also
Miscellaneous functions