GetString GetValue

GetText


The GetText function opens a dialog to request a multi-line text string. If you click [OK], the entered text is returned.

 

Syntax

sText, bOK = GetText( s=nil, sPrompt=nil, sTitle=nil )

Remarks

All arguments are optional and assume default values beyond the last argument you specify. In order to use a default argument but follow it with a specified argument, use a nil in its place.

If the string uses multiple lines, the string should be formatting using the \r\n escape sequence (the so-called carriage return / line feed pair) to separate the lines.

Example

The window shown above was created using the following code. The last argument, the window title, was omitted and left to the default:

 

sText, bOK = GetText(

 

        "It is a tale told by an idiot\r\n" ..

-- text (concatenated by ..)

        "full of sound and fury\r\n" ..

-- text (concatenated by ..)

        "signifying nothing...",

-- text (end of string)

        "Enter some Shakespeare :" )

-- prompt

Related Topics

GetString