High-Level Screen Management Intrinsic Library Reference Manual (32424-90002)
3- 37
If
chngtype
has a
value of 7 or 8, the
content of
chngspec
is ignored.
See "Field Menu" in the
VPLUS/V Reference Manual
for definitions of the
above enhancements, field types, and data types.
cursorposition
A four-byte integer or a 36-byte array of
characters that identifies the field at which
the operator is to begin entering data. It
also tells HPDSEND to position the cursor at
this field. The field must be an input field.
A four-byte integer identifies the beginning
field by number or screen order. A positive
integer indicates a field number. A negative
integer indicates screen order. If you supply
a zero, HPDSEND moves the cursor to the first
input field on the screen.
A 36-byte character array identifies the
beginning field by its USASCII name. This
array must be preceded by a double backslash.
If you pass spaces in this array, HPDSEND moves
the cursor to the first input field on the
screen.
msg
A compound parameter that tells HPDSEND the
message you want displayed in the message
window, and the length of that message. It is
made up of the following subparameters:
msglen
A four-byte integer
that indicates in
bytes the length of
the message you want
HPDSEND to transfer
to the window area.
If you supply a zero,
HPDSEND fills the
window with blanks.
If you supply a
negative number,
HPDSEND does not
update the window
area and the previous
message is displayed.
msgline
A character array of
up to 256 bytes that
identifies the
message you want
HPDSEND to display in
the window area.
datadescrpt
A compound parameter that tells HPDSEND how
data is to be mapped when it is moved between
your application and data fields in the form.
There are six ways to map data. The first and
simplest way is shown below.
-1 = do not transfer data
0 = moves concatenated string of data from
databuf
. The number of bytes moved is equal to
the sum of the lengths of all the fields in the
form. All data is moved as type CHAR.
See Chapter 4 for a description of each of the