Original Author Paul Laughton, 2011
Page 101
De Re BASIC!
Popup <message_sexp> {{, <x_nexp>}{, <y_nexp>}{, <duration_lexp>}}
Pops up a small message for a limited duration. The message is <message_sexp>.
All of the parameters except the message are optional. If omitted, their default values are 0. Use
commas to indicate omitted parameters (see Optional Parameters).
The simplest form of the Popup command, Popup "Hello!", displays the message in the center of the
screen for two seconds.
The default location for the Popup is the center of the screen. The optional <x_nexp> and <y_nexp>
parameters give a displacement from the center. The values may be negative.
Select the duration of the Popup, either 2 seconds or 4 seconds, with the optional <duration_lexp> "long
flag". If the flag is false (the expression evaluates to 0) the message is visible for 2 seconds. If the flag is
true (non-zero) the message is visible for 4 seconds. If the flag is omitted the duration is short.
Select <sel_nvar>, <Array$[]>|<list_nexp> {,<title_sexp> {, <message_sexp> } }
{,<press_lvar> }
The Select command generates a new screen with a list of choices for the user. When the user taps a
screen line, the index of the selected line is returned in the <sel_nvar>. If the user presses the BACK key,
then the returned value is 0.
<Array$[]> is a string array that holds the list of items to be selected. The array is specified without an
index but must have been previously dimensioned, loaded via Array.load, or created by another
command.
As an alternative to an array, a string-type list may be specified in the <list_nexp>.
The <title_sexp> is an optional string expression that is placed into the title bar at the top of the
selection screen. If the parameter is not present, the screen displays a default title. If the expression
evaluates to an empty string ("") the title is blank.
The <message_sexp> is an optional string expression that is displayed in a short Popup message. If the
message is an empty string ("") there is no Popup. If the parameter is absent, the <title_sexp> string is
used instead, but if the <title_sexp> is also missing or empty, there is no Popup.
The <press_lvar> is optional. If present, the type of user tap--long or short--is returned in <press_lvar>.
The value returned is 0 (false) if the user selected the item with a short tap. The value returned is 1
(true) if the user selected the item with a long press.
Use commas to indicate omitted optional parameters (see Optional Parameters).
Text.input <svar>{, { <text_sexp>} , <title_sexp> }
This command is similar to "Input" except that it is used to input and/or edit a large quantity of text. It
opens a new window with scroll bars and full text editing capabilities. You may set the title of the new
window with the optional <title_sexp> parameter.