DoDialogGetString

Prototype

Matrix DoDialogGetString( Matrix mUserInput, String sTitle, String sMessage )

Return Value

The return value is 1 on success or 0 on failure. If the user clicks Cancel or closes the dialog box, the return value is 0.

Parameters

Matrix mUserInput
Upon successful return, this matrix contains the string entered by the user.

String sTitle
The title of the dialog box.

String sMessage
A message that appears at the top of the dialog box.

Remarks

This module displays a dialog box that prompts the user to enter a string. The dialog box accepts any string up to 259 characters long.

Example

title = "Specify Variable Name";
message = "Please enter a name for the variable:";
ok = DoDialogGetString( x, title, message );
if ok then
    print x;
else
    print "Function failed";