HIDE Hide Control

Formats

1.	Hide Control:	HIDE [ CONTROL ] ctl_id [ :idx ] , … [,ERR=stmtref]
2.	Hide Controls:	HIDE [ CONTROL ] string$ [,ERR=stmtref]

Where:

ctl_id	Unique numeric CTL identifier for the object (button, list box, etc.) to be hidden. Numeric expression, integer.
idx	(For Radio Buttons Only) Indicates the specific instance of the radio button group.
stmtref	Program line number or statement label to which to transfer control.
string$	A string or string expression consisting of a series of 3-byte values where byte 1 - 2 of each value is the binary CTL number and byte 3 is the index when addressing a radio button (else ignored).
CONTROL	An optional keyword CONTROL may be specified immediately following the HIDE directive.

Example:

hide control Buttn_1

In addition, the HIDE directive can accept multiple CTL IDs (up to 500) in a comma-separated list, which may be a mix of standard controls and/or radio buttons with idx specifications.

hide Button_1,Button_2,LB_Clients,RB_Credit:1,RB_Credit:3

Description

Use the HIDE directive to hide the specified control from display. The control must be either on the current window or on a global control (e.g. *100). It will still be active for purposes of reading/writing; however, the user cannot see, nor can the program set focus to, the control.

To redisplay a control object, use the SHOW directive.

Note:
The HIDE directive does not work for a Fonted/Fixed Text control unless the control is first assigned to a group. For more information, see Fonted/Fixed Text Control.

See Also

SHOW Show Control

Example

0010 button BTN_VISA,@(10,10,10,2)="&Visa Info"
0020 …
0100 read (1,key=CST_ID$)iol=0110
0110 iolist CST_TERM$,*,*,INV_DT$
0120 gosub 1000
…
1000 if CST_TERM$="VISA" then show BTN_VISA else hide BTN_VISA
1010 return