AskTextBox

Prompts the user for multiple lines of input.

Syntax:

AskTextBox( title, prompt, default, flags, reserved)

Parameters:

(s) title: title of the dialog box.

(s) prompt: question to be put to the user.

(s) default: default answer.

(i) flags: see below.

(i) reserved: reserved for future use, should be set to 0.

Returns:

(s) text: Returns the text input by user.

 

"default" can contain multiple lines of text, using embedded @CRLF's.

 

"flags" can be set to 0, or can specify one or more of the following values combined with the bitwise OR ('|') operator:

 

Value

Meaning

0

none of the following apply 

1

do not automatically wrap text 

2

place cursor at end of default text (instead of highlighting it) 

 

 

The return value is whatever the user enters in the edit box. If multiple lines of text are entered, they will be delimited in the returned string with @CRLF's.

Note: a horizontal scroll bar is added if "flag" number 1 is specified. Also, the cursor is scrolled into view if "flag" number 2 is specified.

The function IntControl (63, p1, p2, p3, p4) can be used to set the coordinates for AskFileText, AskItemList and AskTextBox windows.

 

Example:

ret=AskTextbox( "User satisfaction","Please type any comments here", "NOCOMMENT", 0, 0)
If ret=="NOCOMMENT"
   Message("User input","Default returned. No user input" )
Else
   Message("User input",ret)
EndIf
Exit
See Also:

AskLine, AskYesNo, Dialog