HP Data Entry and Forms Management System (VPLUS) Reference Manual (32209-90024)

258 Chapter6
USING VPLUS INTRINSICS
INTRINSIC DESCRIPTIONS
VARMSCP
Arms or disarms cursor sensing capability.
Syntax
VARMSCP {comarea,scpenable}
Parameters
comarea Must be comarea name specified when the forms file was opened with
VOPENFORMF. If not already set, the following comarea items must be set
before calling VARMSCP:
cstatus Set to zero.
comarealen Set to total number of two-byte words
comarea . Must be at
least 70 words in length.
VARMSCP May set the following comarea item, cstatus.
cstatus Set to nonzero value if call is unsuccessful.
scpenable Two-byte logical variable which determines whether the cursor position
sensing is enabled or not.
• 0 - Disarm cursor sensing.
• 1 - Arm cursor sensing.
Discussion
When cursor sensing is armed, the data returned after a read, as in VREADFIELDS, is
prefixed with an escape sequence which contains the position of the cursor on the screen
when the read terminated. This information is used by VGETSCPFIELD and VGETSCPDATA to
retrieve the cursor position.
When cursor sensing is disarmed, no cursor position information is available following a
read. VREADFIELDS automatically disarms cursor sensing. VARMSCP should be called prior
to a cursor sensing transaction to arm the cursor sensing function for the next read. This
deletes any existing cursor location information.
Example
COBOL
CALL “VARMSCP” USING COMAREA SCP-ENABLE.
SPL
VARMSCP(COMAREA,SCP’ENABLE);
These calls arm/disarm cursor sensing depending on whether the second parameter
contains a 1 or a 0 respectively.