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

Chapter 6 281
USING VPLUS INTRINSICS
INTRINSIC DESCRIPTIONS
field, and the name of the form containing the fields.
Passing INFOBUF Without Entering Keys
Keys are optional. If you do not supply a key to indicate the first field you want
information about, VGETFIELDINFO starts with the first field not already reported on by the
current call.
As an example, suppose you want information about 10 fields, and you enter screen order
numbers 3, 5, and 6 as keys. VGETFIELDINFO returns information about fields 3, 5, 6, and 7
through 13. If you enter no keys, VGETFIELDINFO returns information about fields 1
through 10.
Table Wraparound
VGETFIELDINFO starts over with the first field in the form if you request information about
more fields than are in the form or, if when you pass a key, your request goes beyond the
end of the form.
Suppose a form has 12 fields. If you request information about 10 of the fields and enter
screen order number 8 as a key, VGETFIELDINFO returns information about fields 8
through 12, and then goes to the beginning of the form and returns information about
fields 1 through 5.
Table 6-10. Field Information Buffer
Data Type Position Contents Comments
Integer (Two-byte) 1 numofentries Required
2 entrylength Required
Character Array
(16-byte)
3-10 formname Required; second byte of position 10
is unused
11-18 Field name Permissiblekey;last byte of position
18 is unused
Integer (Two-byte) 19 Field number according
to screen order
Permissible key
20 Field number Permissible key; in order of creation
21 Field length In bytes
22 Position of field in data
buffer
In bytes, offset from zero
Character Array
(4-byte)
23-24 Field enhancement Combination of I, H, U, B, 1-8,
or NONE.
25-26 Data type of field May be CHAR, DIG, IMP n , date (MDY,
DMY, YMD), or NUM[n].
Character
(Two-byte)
27 Field type First byte of position 27; may be O,
R, P or D.