All Functions
MsgBox Function
FUNCTION: InputBox( )
Implemented in version 1.0
InputBox
(Prompt,
Title, Default, Xpos, Ypos, HelpFile, Context
)
The
InputBox
function creates a prompt for an input dialog box.
The dialog box usually asks a question and prompts a reply from the user.
If the user clicks the OK button or presses ENTER, the
InputBox
function returns all text inside the text box. If the user clicks the CANCEL button, a zero-length string "" is returned.
There is one mandatory argument.
Prompt
The
Prompt
argument is the message string (question) that appears in the dialog box.
Code:
<% INPUT TYPE="BUTTON" NAME="button0" VALUE="Click Here!" %>
< SCRIPT LANGUAGE="VBScript" >
Sub button0_onclick
Dim returntext
returntext = InputBox("This is an input box!")
End Sub
< /SCRIPT >
Output:
There are six optional arguments.
Title
The optional
Title
argument is the title that appears at the top of the dialog box window.
Code:
<% INPUT TYPE="BUTTON" NAME="button1" VALUE="Click Here!" %>
< SCRIPT LANGUAGE="VBScript" >
Sub button1_onclick
Dim returntext promptext
prompttext = "This is an input box!"
prompttext = prompttext &(chr(13) & chr(10))
prompttext = prompttext & "We added a second line!"
returntext = InputBox(prompttext, "INPUT Function")
End Sub
< /SCRIPT >
Output:
Default
The optional
Default
argument is the text that will appear in the reply window in the dialog box.
Code:
<% INPUT TYPE="BUTTON" NAME="button2" VALUE="Click Here!" %>
< SCRIPT LANGUAGE="VBScript" >
Sub button2_onclick
Dim returntext promptext titletext
prompttext = "This is an input box!"
titletext = "INPUT function"
returntext = InputBox(prompttext, titletext, "Any text you wish...")
End Sub
< /SCRIPT >
Output:
Xpos
The optional
Xpos
argument determines the horizontal position of the dialog box in the viewing screen. It is the number of twips from the left side of the screen to the left edge of the dialog box. Twips are a graphical value used to set the ScaleMode property of an object.
Ypos
The optional
Ypos
argument determines the vertical position of the dialog box in the viewing screen. It is the number of twips from the top of the screen to the top edge of the dialog box. Twips are a graphical value used to set the ScaleMode property of an object.
Code:
<% INPUT TYPE="BUTTON" NAME="button3" VALUE="Click Here!" %>
< SCRIPT LANGUAGE="VBScript" >
Sub button3_onclick
Dim returntext promptext titletext
prompttext = "This is an input box!"
titletext = "INPUT function"
defaulttext = "Upper left corner"
returntext = InputBox(prompttext, titletext, defaulttext, 150, 150)
End Sub
< /SCRIPT >
Output:
HelpFile
Context
The optional
HelpFile
argument specifies the location of the help file.
The optional
Context
argument specifies the help context number in the help file.
Not demonstrated.
Copyright 1999-2001 by Infinite Software Solutions, Inc. All rights reserved.
Trademark Information