DADiSP Worksheet Functions > Function Categories > Menu Functions > GETSTRING

 

GETSTRING

Purpose:

Prompts for text via an input panel with OK and Cancel buttons.

Syntax:

GETSTRING("label", "message", "default")

"label"

-

A string used to label the top of the input panel.

"message"

-

A string used for a message within the input panel.

"default"

-

A string placed as a default in the input panel.

Returns:

User input string.

Example:

getstring("Label","Column Header","Column 1")

 

pops up the input panel and prompts for a string. The default value, column 1, is displayed in the input panel. The value entered in the panel is displayed on the status line.

 

mylabel = Getstring("Label","Column Header","Col 1");

setcomment(mylabel)

 

pops up the input panel and prompts for a string. The text entered into the panel is stored in the variable mylabel, then is set to the comment for the series.

Remarks:

GETSTRING is useful in SPL functions and Command Files for requesting user input.

See Also:

INPUT

MESSAGE