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

286 Chapter6
USING VPLUS INTRINSICS
INTRINSIC DESCRIPTIONS
VGETFORMINFO
Returns information about specified forms to an application.
Syntax
VGETFORMINFO { comarea,infobuf,infobuflen }
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 VGETFORMINFO:
cstatus Set to zero.
comarealen Set to total number of two-byte words in comarea .
VGETFORMINFO sets the following field:
cstatus Set to nonzero value if call unsuccessful.
infobuf A record through which you pass the request for form information and to
which the intrinsic returns thespecified information. This parameter must
be initialized to spaces before filling in your request and calling
VGETFORMINFO. The layout of
infobuf is shown in Table 6-12. The two
required fields of
infobuf pass user-supplied parameters to
VGETFORMINFO as follows:
nurmofentries Specifies how many forms you want information about.
entrylength Indicates how many two-byte words of information
(maximum 36 as shown in Table 6-12.) you want about
each form.
The rest of
infobuf (beginning with word 3) must consist of entrylength
number of two-byte words for each form you want information about.
Thus, the total length of
infobuf in two-byte words must be as follows;
2 + (
entrylength * numofentries )
You may pass one or both of the two permissible keys, which must be
passed in the position indicated in the table. Remember that
infobuf
must be initialized to spaces before filling in the parameters and any key.
infobuflen Two-byte integer variable set to the number of two-byte words in infobuf .
Discussion
This intrinsic accesses an internal table and places information about forms into infobuf .
You tell VGETFORMINFO how many forms and how much information you want about each
form.