_WShow( ) API Library Routine

Displays a hidden window on the screen.

void _WShow(WHANDLE wh)
WHANDLE wh;            /* Window handle. */

Remarks

When you create a window, it is hidden by default until you use _WShow( ) to make it visible.

For more information on how to create an API library and integrate it with Visual FoxPro, see Accessing the Visual FoxPro API.

Example

The following example contains two API routines. WINOPEN( ) opens a window but doesn't call _WShow( ), illustrating that the window is hidden until _WShow( ) displays it on the screen.

Visual FoxPro Code

SET LIBRARY TO WSHOW 
wh = WOPEN()
= WSHOW(wh)

C Code

#include <pro_ext.h>

FAR WOpen(ParamBlk FAR *parm)
{
   _RetInt(_WOpen(2, 2, 20, 70, WEVENT | CLOSE, WINDOW_SCHEME,
      (Scheme FAR *) 0, WO_SYSTEMBORDER), 10);
}

FAR WShow(ParamBlk FAR *parm)
{
   _WShow(parm->p[0].val.ev_long);
}

FoxInfo myFoxInfo[] = {
   {"WOPEN", (FPFI) WOpen, 0, ""},
   {"WSHOW", (FPFI) WShow, 1, "I"},
};
FoxTable _FoxTable = {
   (FoxTable FAR *) 0, sizeof(myFoxInfo)/sizeof(FoxInfo), myFoxInfo
};

See Also

_WHide( ) API Library Routine | _WOpen( ) API Library Routine | _WSelect( ) API Library Routine | Accessing the Visual FoxPro API | _WOpen( ) API Library Routine