SHOW OBJECT Command

Included for backward compatibility. Use the Refresh method to redisplay a control after changing the control's properties.

This command is undocumented in the original VFP9 help file,
but the following documentation was found in the FoxPro for Windows 2.6 help, and may still be valid:

Redisplays the @ ... GET control that has the specified object number.

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

Parameters

expN1
 Every control has an associated control number (expN1), which is determined by the order in which that control was created. Each button within a set of push, radio and invisible buttons is considered a separate control. A field, check box, popup, list, spinner or text-editing region is also a single control.

ENABLE | DISABLE
 Including ENABLE allows the specified control to be selected or chosen. Including DISABLE prevents the control from being selected or chosen.

LEVEL expN2
 You can nest READs by issuing @ ... GETS and a READ in a routine that is called an active READ. READs can be nested to five levels.

 SHOW OBJECT defaults to the current READ level if LEVEL is omitted. Including LEVEL lets you redisplay a control on a 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 control to redisplay. RDLEVEL() returns the current READ level.

PROMPT expC
 You can replace the prompt for an individual push button, radio button or check box with another prompt by including PROMPT expC. expC replaces the original button or check box prompt. You can also change the button or check box attributes (which determine whether the control is enabled or disabled, which hot keys are assigned, and whether it is the default or Esc choice) by specifying the appropriate special characters with expC.

COLOR SCHEME expN3 | COLOR color pair list
 Controls can be redisplayed in the colors you specify. For more information about control colors, see @ ... GET and @ ... EDIT - Text Edit Regions.

Expand imageRemarks

Expand imageExample

Expand imageSee Also


© , 1996-2020 • Updated: 11/10/20
Comment or report problem with topic