Difference between revisions of "MESSAGE"

From Recital Documentation Wiki
Jump to: navigation, search
 
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
=MESSAGE=
 
 
 
==Class==
 
Screen Forms
 
 
 
 
==Purpose==
 
==Purpose==
 
Display message in the message line, and halt program execution until a key is pressed
 
Display message in the message line, and halt program execution until a key is pressed
Line 15: Line 8:
  
 
==See Also==
 
==See Also==
[[DIALOG BOX]], [[SET MESSAGE]], [[SET STATUS]]
+
[[DIALOG BOX]], [[INKEY()]], [[SET MESSAGE]], [[SET STATUS]], [[WAIT]]
  
  
Line 29: Line 22:
 
seek "BALLET"
 
seek "BALLET"
 
if not found()
 
if not found()
message "Record not found.  Continue?" query
+
    message "Record not found.  Continue?" query
endif
+
    if lastkey()=asc("N")
if lastkey()=asc("N")
+
        quit
quit
+
    endif
 
endif
 
endif
 
</code>
 
</code>
Line 38: Line 31:
  
 
==Products==
 
==Products==
Recital Mirage Server, Recital Terminal Developer
+
Recital  
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Commands]]
 
[[Category:Commands]]
 +
[[Category:Screen Forms]]
 +
[[Category:Screen Forms Commands]]
 +
[[Category:Keyboard Events]]
 +
[[Category:Keyboard Events Commands]]

Latest revision as of 14:47, 12 November 2009

Purpose

Display message in the message line, and halt program execution until a key is pressed


Syntax

MESSAGE <expC> [QUERY]


See Also

DIALOG BOX, INKEY(), SET MESSAGE, SET STATUS, WAIT


Description

The MESSAGE command displays the specified character string on line 24, and waits for any key to be pressed before continuing. If SET STATUS is OFF then the message will not be displayed, but rather the bell will sound on the terminal. Whenever the message is displayed, the current cursor position is saved, and then restored after a key has been pressed. The message is automatically erased from line 24 after a key has been pressed. To change the MESSAGE line from line 24, set MESSAGE ON, STATUS OFF and SCOREBOARD OFF. Then use the SET MESSAGE AT and SET MESSAGE TO commands to reposition the message line.

QUERY

If the QUERY keyword is specified, then the message is displayed in a YES/NO dialog box. The response made at the keyboard can be trapped using the LASTKEY() function.


Example

seek "BALLET"
if not found()
    message "Record not found.  Continue?" query
    if lastkey()=asc("N")
        quit
    endif
endif


Products

Recital