Oracle Forms Developer – Form Builder Reference, Volume 1

SYSTEM.MODE system variable
Syntax
SYSTEM.MODE
Description
SYSTEM.MODE indicates whether the form is in Normal, Enter Query, or Fetch Processing mode. The
value is always a character string.
Usage Notes
398
NORMAL Indicates that the form is currently in normal processing mode.
ENTER-QUERY Indicates that the form is currently in Enter Query mode.
QUERY Indicates that the form is currently in fetch processing mode,
meaning that a query is currently being processed.
When using SYSTEM.MODE to check whether the current block is in Enter Query mode, be aware that
if testing from a When-Button-Pressed trigger in a control block, Enter Query mode will never be
entered, because the control block is not the current block.
SYSTEM.MODE examples
Assume that you want Form Builder to display an LOV when the operator enters query mode and the
input focus is in a particular text item. The following trigger accomplishes that operation.
/*
** When-New-Item-Instance trigger
*/
BEGIN
IF :System.Cursor_Item = ’EMP.EMPNO’ and
:System.Mode = ’ENTER-QUERY’
THEN
IF NOT Show_Lov(’my_lov’) THEN
RAISE Form_trigger_Failure;
END IF;
END;