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

280 Chapter6
USING VPLUS INTRINSICS
INTRINSIC DESCRIPTIONS
VGETFIELDINFO
Returns information about specified fields to an application.
Syntax
VGETFIELDINFO { 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 VGETFIELDINFO:
cstatus Set to zero.
comarealen Set to total number of two-byte words in comarea .
VGETFIELDINFO may set the following
comarea item:
cstatus Set to nonzero value if call unsuccessful.
infobuf A record through which you pass the request for field information and to
which the intrinsic returns thespecified information. This parameter must
be initialized to spaces before filling in your request and calling
VGETFIELDINFO. The layout of
infobuf is shown in Table 6-10.. The three
required fields of
infobuf pass user-supplied parameters to
VGETFIELDINFO as follows:
numofentries Specifies how many fields you want information about.
entrylength Indicates how many two-byte words of information
(maximum 17 as shown in Table 6-10.) you want about
each field.
formname The name of the form that contains the fields you are
inquiring about.
The rest of
infobuf (beginning with position 11) must consist of
entrylength number of words for each field you want information about.
Thus, the total length of
infobuf in words must be as follows:
10+( entrylength * numofentries )
You may pass one or more of the three 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 one or more fields
into
infobuf . You tell VGETFIELDINFO how many fields, how much information about each