Original Author Paul Laughton, 2011
Page 98
De Re BASIC!
Console.line.touched <line_nvar> {, <press_lvar>}
After an OnConsoleTouch interrupt indicates the user has touched the console, this command returns
information about the touch.
The number of the line that the user touched is returned in the <line_nvar>.
If the optional <press_lvar> is present, the type of user toucha short tap or a long pressis returned in
the <press_lvar>. Its value will be 0 (false) if the touch was a short tap. Its value will be 1 (true) if the
touch was a long press.
Console.save <filename_sexp>
The current contents of the Console is saved to the text file specified by the filename string expression.
Console.title { <title_sexp>}
Changes the title of the console window. If the <title_sexp> parameter is omitted, the title is changed to
the default title, "BASIC! Program Output".
User Input and Interaction
This set of commands lets you interact with your programs.
At the lowest level, you can use Inkey$ to read raw keystrokes. You control display of the virtual
keyboard with Kb.hide, Kb.show, and Kb.toggle.
With the Select command you present information in a list format that looks very much like the Output
Console. If you prefer, you can use Dialog.Select to present the same information in a new dialog
window. Either way, when your program runs, you select an item from the list by tapping a line.
The other commands in this group all pop up new windows.
Input lets you type a number or a line of text as input to your program. Dialog.message presents a
message with a set of buttons to let you tell your program what to do next.
Popup is different. It presents information in a small, temporary display. It is not interactive and requires
no management in your program. You pop it up and forget it.
The last two commands in this group present another kind of dialog window. The Text.input command
operates on larger blocks of text, and TGet simulates terminal I/O.
Dialog.message {<title_sexp>}, {<message_sexp>}, <sel_nvar> {, <button1_sexp>{,
<button2_sexp>{, <button3_sexp>}}}
Generates a dialog box with a title, a message, and up to three buttons. When the user taps a button,
the number of the selected button is returned in <sel_nvar>. If the user taps the screen outside of the
message dialog or presses the BACK key, then the returned value is 0.