Oracle Forms Developer – Form Builder Reference, Volume 1

SYSTEM.CURSOR_ITEM system variable
Syntax
SYSTEM.CURSOR_ITEM
Description
SYSTEM.CURSOR_ITEM represents the name of the block and item, block.item, where the input focus
(cursor) is located.
The value is always a character string.
Usage Notes
Within a given trigger, the value of SYSTEM.CURSOR_ITEM changes when navigation takes place.
This differs from SYSTEM.TRIGGER_ITEM, which remains the same from the beginning to the end of
single trigger.
SYSTEM.CURSOR_ITEM restrictions
Avoid using SYSTEM.CURSOR_ITEM in triggers where the current navigation unit is not the item,
such as Pre- and Post-Record, Block, and Form triggers. In these triggers, the value of
SYSTEM.CURSOR_ITEM is NULL.
SYSTEM.CURSOR_ITEM examples
Assume that you want to create a user-defined procedure that takes the value of the item where the cursor
is located (represented by SYSTEM.CURSOR_VALUE), then multiplies the value by a constant, and
then reads the modified value into the same item. The following user-defined procedure uses the COPY
built-in to perform this function.
PROCEDURE CALC_VALUE IS
new_value NUMBER;
BEGIN
new_value := TO_NUMBER(:System.Cursor_Value) * .06;
Copy(TO_CHAR(new_value), :System.Cursor_Item);
END;
383