Difference between revisions of "SET MESSAGE"

From Recital Documentation Wiki
Jump to: navigation, search
 
 
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
=SET MESSAGE=
 
 
 
==Class==
 
Screen Environment
 
 
 
 
==Purpose==
 
==Purpose==
 
Control the display of messages
 
Control the display of messages
Line 12: Line 5:
 
==Syntax==
 
==Syntax==
 
SET MESSAGE TO <expC> | [<expN> [CENTER] [CENTRE]]
 
SET MESSAGE TO <expC> | [<expN> [CENTER] [CENTRE]]
 +
 
SET MESSAGE AT <expN1>,<expN2> TO <expN3>,<expN4>  |  DEFAULT
 
SET MESSAGE AT <expN1>,<expN2> TO <expN3>,<expN4>  |  DEFAULT
 +
 
SET MESSAGE ON | OFF | (<expL>)
 
SET MESSAGE ON | OFF | (<expL>)
  
  
 
==See Also==
 
==See Also==
DIALOG BOX, MESSAGE, SET STATUS, SET SCOREBOARD
+
[[DIALOG BOX]], [[Function Keys]], [[MESSAGE]], [[MESSAGEBOX()]], [[SET DIALOG]], [[SET NOTIFY]], [[SET SAFETY]], [[SET SCOREBOARD]], [[SET STATUS]], [[SET TALK]], [[SET VERIFY]], [[WAIT]]
  
  
Line 31: Line 26:
  
 
==Example==
 
==Example==
<pre>
+
<code lang="recital">
 
set status off
 
set status off
 
set message at 10,10 to 10,50
 
set message at 10,10 to 10,50
set message to "Name and address not; specified."
+
set message to "Name and address not specified."
  
 
// Another example
 
// Another example
Line 40: Line 35:
 
seek "BALLET"
 
seek "BALLET"
 
if not found()
 
if not found()
set message to "Key not found."
+
    set message to "Key not found."
endif</pre>
+
endif
 +
</code>
  
  
 
==Products==
 
==Products==
Recital Mirage Server, Recital Terminal Developer
+
Recital  
 +
[[Category:Documentation]]
 +
[[Category:Commands]]
 +
[[Category:Set_Commands|MESSAGE]]
 +
[[Category:Screen Environment]]
 +
[[Category:Screen Environment Set Commands]]

Latest revision as of 16:22, 23 November 2009

Purpose

Control the display of messages


Syntax

SET MESSAGE TO <expC> | [<expN> [CENTER] [CENTRE]]

SET MESSAGE AT <expN1>,<expN2> TO <expN3>,<expN4> | DEFAULT

SET MESSAGE ON | OFF | (<expL>)


See Also

DIALOG BOX, Function Keys, MESSAGE, MESSAGEBOX(), SET DIALOG, SET NOTIFY, SET SAFETY, SET SCOREBOARD, SET STATUS, SET TALK, SET VERIFY, WAIT


Description

The SET MESSAGE command is used to create a message, consisting of the character string <expC>, and to determine where and when it will be displayed. The MESSAGE TO <expC> command displays messages without waiting for any user input. This command is very useful for displaying helpful messages, during long operations, to let the user know what is happening. If the command STATUS is set ON, the <expC> is centered in the message line.

If SET MESSAGE TO is issued with no <expC> specified, the relevant message line will be cleared. If SET STATUS is OFF, then no message will be displayed. By default, STATUS is ON.

The SET MESSAGE command, with the AT <expN1> TO <expN2> option, can be used to position the message line at any chosen position on the screen. This is particularly useful when working with menus. SET MESSAGE AT DEFAULT reselects the default position setting of line 24, for all messages. SET MESSAGE can be optionally centered with the keywords CENTER or CENTRE.

If STATUS is OFF and SCOREBOARD is ON, messages appear on the top line of the screen. If STATUS is OFF and SCOREBOARD is OFF then messages are disabled unless MESSAGE is ON. Note that if messages are fully disabled (STATUS OFF, SCOREBOARD OFF and MESSAGE OFF), the [FIND] and [FINDNEXT] keys are ignored. By default, MESSAGE is ON.


Example

set status off
set message at 10,10 to 10,50
set message to "Name and address not specified."
 
// Another example
use patrons index events, dates, names
seek "BALLET"
if not found()
    set message to "Key not found."
endif


Products

Recital