Difference between revisions of "ON TIMEOUT"

From Recital Documentation Wiki
Jump to: navigation, search
 
Line 1: Line 1:
=ON TIMEOUT=
 
 
 
 
==Class==
 
==Class==
 
Keyboard Events
 
Keyboard Events
Line 20: Line 17:
 
==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 25:
 
<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 46: Line 45:
 
[[Category:Documentation]]
 
[[Category:Documentation]]
 
[[Category:Commands]]
 
[[Category:Commands]]
 +
[[Category:Keyboard Events]]
 +
[[Category:Keyboard Events Commands]]

Revision as of 09:58, 3 June 2009

Class

Keyboard Events


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 Mirage Server, Recital Terminal Developer