Difference between revisions of "ON TIMEOUT"

From Recital Documentation Wiki
Jump to: navigation, search
 
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
=ON TIMEOUT=
 
 
 
==Class==
 
Keyboard Events
 
 
 
 
==Purpose==
 
==Purpose==
 
Execute a command when the timeout event flag is triggered
 
Execute a command when the timeout event flag is triggered
Line 20: Line 13:
 
==Description==
 
==Description==
 
The ON TIMEOUT command is used to specify a single command that will execute when the timeout event flag has been triggered.  The timeout period is defined by the SET TIMEOUT command.  Issuing an ON TIMEOUT statement without a <command> clears the previous ON TIMEOUT.  SET CLOCK ON must be active for the timeout command to function, but the SET CLOCKDISPLAY command can be set to OFF if no visible clock is required.
 
The ON TIMEOUT command is used to specify a single command that will execute when the timeout event flag has been triggered.  The timeout period is defined by the SET TIMEOUT command.  Issuing an ON TIMEOUT statement without a <command> clears the previous ON TIMEOUT.  SET CLOCK ON must be active for the timeout command to function, but the SET CLOCKDISPLAY command can be set to OFF if no visible clock is required.
<command>The specified command may be any the Recital/4GL command.
+
 
 +
====<command>====
 +
The specified command may be any the Recital/4GL command.
  
  
Line 26: Line 21:
 
<code lang="recital">
 
<code lang="recital">
 
procedure p_timeout
 
procedure p_timeout
dialog box "Timeout Occurred"
+
  dialog box "Timeout Occurred"
set timeout off
+
  set timeout off
quit
+
  quit
 
return
 
return
  
Line 43: Line 38:
  
 
==Products==
 
==Products==
Recital Mirage Server, Recital Terminal Developer
+
Recital  
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Commands]]
 
[[Category:Commands]]
 +
[[Category:Keyboard Events]]
 +
[[Category:Keyboard Events Commands]]

Latest revision as of 15:50, 12 November 2009

Purpose

Execute a command when the timeout event flag is triggered


Syntax

ON TIMEOUT [<command>]


See Also

SET CLOCK, SET CLOCKDISPLAY, SET TIMEOUT


Description

The ON TIMEOUT command is used to specify a single command that will execute when the timeout event flag has been triggered. The timeout period is defined by the SET TIMEOUT command. Issuing an ON TIMEOUT statement without a <command> clears the previous ON TIMEOUT. SET CLOCK ON must be active for the timeout command to function, but the SET CLOCKDISPLAY command can be set to OFF if no visible clock is required.

<command>

The specified command may be any the Recital/4GL command.


Example

procedure p_timeout
  dialog box "Timeout Occurred"
  set timeout off
  quit
return
 
set clock on
on timeout do p_timeout
set timeout to 20
set timeout on
m_var = space(10)
@ 00,00 say "Enter Value:" get m_var
read
return


Products

Recital