The HIDFLD xcall subroutine is designed to be used with and ESP screen to
allow a program to set the HIDE or SHOW status of an ESP screen field.
Usually this function is accessed by the expression handler for an ESP
screen via the function HIDE(F??) where ?? is the field number or
SHOW(F??) where ?? is the field number. For instance an ESP screen field
expression could be as follows:
Field Expression:
IF(POPUP'ITEM(F1)=1, HIDE(F2), SHOW(F2)
This expression would evaluate to:
If the popup item for field one is the first item then HIDE field 2
else
SHOW field 2
There are times when you may want a basic program to handle the HIDE and
SHOW status of a particular field. To this end we now have HIDFLD.SBR.
Usage:
XCALL HIDFLD, SCREEN, FLAG, FIELD {, FIELD {, FIELD (, ....}}
Where:
SCREEN = the ESP screen Fetched into the basic program using
XCALL FETCH subroutine
FLAG = TRUE (not-zero) Will HIDE a field
FALSE (zero) Will SHOW a field.
FIELD = the number of the field to set HIDE or SHOW status.
For Example:
HIDE = 1
XCALL HIDFLD, SCREEN1, HIDE, 4, 5, 6, 10
will HIDE Fields 4, 5, 6, and 10 of the specified ESP screen.
SHOW = 0
XCALL HIDFLD, SCREEN1, SHOW, 4, 5, 6, 10
will SHOW fields 4, 5, 6, and 10 of the specified ESP screen.
This enables you to set or reset an ESP screen field's HIDE or SHOW
status from a BASIC program even if the HIDE or SHOW status of an
ESP screen fields expression value has set or reset the HIDE or SHOW
status.
For BASIC examples see the file HIDSKP.BAS in the ESP account on the
AMUS Network. ALSO get the following:
SKPFLD.SBR - SKIP or ALLOW field.
HIDFLD.SBR - HIDE or SHOW field.
GETPUI.SBR - GET POPUP'ITEM value.
SETPUI.SBR - SET POPUP'ITEM value.
HIDSKP.BAS - BASIC program that demonstrates usage.
HIDSKP.SCR - ESP Screen used with HIDSKP.BAS
Any comments or suggestions should be sent to GR/AM on the AMUS Network.
