prompt2

Creates a box for prompt text.

Available in:

Apps (win) Apps (char) Reportwriter RPC Standalone PL
X X X X  

Syntax

string prompt2(row,col,text[,text...],field-text,len,visual,box)
int            row,col,len,visual,box
string         text,field-text

Description

Returns user input.
row specifies the row position for the displayed window. -1 places the upper left of the box at the cursor position. -2 places the box in the center of the screen.

col specifies column location of the view box; -1 places the upper left of the box at the cursor position. -2 places the box in the center of the screen.

text (optional) specifies one or more text lines.

field-text specifies text to be placed in field.

len specifies the length of text field.

visual specifies visual attribute of field.

box allows you to draw a box around prompt. If this value is true (nonzero), the function draws a box.

Notes

The number of text lines and the last text plus len determine the box size. The field is placed after the last text line. Keys 0 and 3 return except if len is 1, in which case all keys return. If key 0 or OK is clicked, G.aux = true. Otherwise G.aux = false.

The prompt window is always closed on exit. Use refresh(false) to give the appearance of remaining open if needed for error handling.