READMODE()
From Recital Documentation Wiki
		Revision as of 16:01, 28 October 2009 by Helengeorge  (Talk | contribs)
Purpose
Function to return a character string describing the 'read' mode for the currently active form
Syntax
READMODE()
See Also
SET(), SYS(), SET PREFORM, SET PRERECORD, CREATE, @...GET, SET POSTRECORD, SET POSTFORM, MODIFY STRUCTURE
Description
The READMODE() function returns a character string describing the 'read' mode for the currently active form. Any of the following strings can be returned.
| Readmode | Description | 
|---|---|
| READ | READ command is active | 
| EDIT | EDIT command is active | 
| CHANGE | CHANGE command is active | 
| INSERT | INSERT command is active | 
| QUERY | QUERY command is active | 
| APPEND | APPEND command is active | 
| No form active | 
The READMODE() function always returns a character string in upper case.  This function is very useful when used in table and form triggers for determining the current read state for conditional coding.
Example
// Pre-record trigger procedure procedure form_trigger if readmode() = "APPEND" return else //...commands endif return use accounts set form to details set prerecord to form_trigger edit
Products
Recital Mirage Server, Recital Terminal Developer
