READMODE()

READMODE()

Class

Screen Forms

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