Syntax |
AskBox[$](prompt$ [,[default$] [,[title$][,helpfile,context]]]) |
|
Description |
Displays a dialog box requesting input from the user and returns that input as a String. |
|
Comments |
The AskBox/AskBox$ functions take the following parameters: |
|
|
Parameter |
Description |
|
prompt$ |
String containing the text to be displayed above the text box. The dialog box is sized to the appropriate width depending on the width of prompt$. A runtime error is generated if prompt$ is Null. |
|
default$ |
String containing the initial content of the text box. The user can return the default by immediately selecting OK. A runtime error is generated if default$ is Null. |
|
title$ |
String specifying the title of the dialog. If missing, then the default title is used. |
|
helpfile |
Name of the file containing context-sensitive help for this dialog. If this parameter is specified, then context must also be specified. |
|
context |
Number specifying the ID of the topic within helpfile for this dialog's help. If this parameter is specified, then helpfile must also be specified. |
|
Function |
Returns |
|
AskBox$ |
String containing the input typed by the user in the text box. A zero-length string is returned if the user selects Cancel. |
|
AskBox |
String variant containing the input typed by the user in the text box. An Empty variant is returned if the user selects Cancel. |
|
When the dialog box is displayed, the text box has the focus. The user can type a maximum of 255 characters into the text box displayed by AskBox$. If both the helpfile and context parameters are specified, then a Help button is added in addition to the OK and Cancel buttons. Context-sensitive help can be invoked by selecting this button or using the help key (F1). Invoking help does not remove the dialog. |
|
|
s$ = AskBox$("Type in the filename:")
s$ = AskBox$("Type in the filename:","filename.txt")
|
|
Example |
This example asks the user to enter a filename and then displays what he or she has typed. Sub Main() s$ = AskBox$("Type in the
filename:") |
|
See Also |
MsgBox (statement); AskPassword$ (function); InputBox, InputBox$ (functions); OpenFilename$ (function); SaveFilename$ (function); SelectBox (function). |
|
Note |
The text in the dialog box is displayed in 8-point MS Sans Serif. |
A |