+---------------------------------+
|           SHOW OBJECT           |
+---------------------------------+
SHOW OBJECT <expN1>
        [ENABLE | DISABLE]
        [LEVEL <expN2>]
        [PROMPT <expC>]
        [COLOR <color pair list>
        | COLOR SCHEME <expN3>]

-----------------------------------
Redisplays single GET object.
-----------------------------------

SHOW OBJECT can also be used to redisplay an individual button from a
set of invisible, radio or push buttons.  When an object is redisplayed
it may be enabled or disabled, and you may change the prompts of check
boxes and buttons.

A routine containing SHOW OBJECT can be used to redisplay a GET object.
A GET level VALID or WHEN, or a READ level ACTIVATE or DEACTIVATE
routine could contain a SHOW OBJECT.

<expN1>
        Every object has an associated object number <expN1>.  An object's
number is determined by the order the objects are defined.  Each button
within push, radio and invisible buttons is considered a separate
object.  A field, check box, popup, list or text editing region is also
a single object.

ENABLE | DISABLE
        ENABLE allows an object to be selected or chosen.  DISABLE prevents an
object from being selected or chosen.

LEVEL <expN2>
        Nested READs can be created by issuing GETs and a READ in a routine
called while in READ.  READs can be nested to five levels.

        If LEVEL isn't included, SHOW OBJECT defaults to the current READ
level.  Including LEVEL lets you redisplay an object on a READ level
other than the current level.  The numeric expression <expN2> can assume
the value 1, 2, 3, 4 or 5 corresponding to the READ level of the object
you want to redisplay.

PROMPT <expC>
        Prompt for individual push buttons, radio buttons or a check box may be
replaced with another by including PROMPT <expC>. <expC> replaces the
original button or check box prompt.  The button or check box attributes
(enabled, disabled, hot keys, default choice or escape choice) may also
be changed by including the appropriate special characters in <expC>.

COLOR <color pair list>
COLOR SCHEME <expN3>
        Objects may be redisplayed in the colors you specify.  You can include
COLOR with a <color pair listing> or COLOR SCHEME with a COLOR SCHEME
number <expN3>.

+---------------------------------+
|         Program Example         |
+---------------------------------+
The following example creates a check box.  When the check box is
chosen, the VALID routine NEWPROMPT is executed.  The NEWPROMPT routine
changes the check box prompt and the hot key.

CLEAR
STORE 1 TO check
@4,2 GET check FUNCTION '*C \<Checked' SIZE 1,13 VALID NEWPROMPT()
READ CYCLE

FUNCTION newprompt
IF check = 0
        SHOW OBJECT 1 PROMPT '\<Unchecked'
ELSE
        SHOW OBJECT 1 PROMPT '\<Checked'
ENDIF
RETURN .T.

-----------------------------------

See Also:  @ ... SAY/GET, CLEAR, _CUROBJ, OBJNUM(), RDLEVEL(), READ,
SHOW GET, SHOW GETS, SYS(2016) SHOW GETS WINDOW

-----------------------------------