win12.hlp (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
WinShowWindow (1.2)
Function Group                                      Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINWINDOWMGR
 
BOOL WinShowWindow(hwnd, fShow)
HWND hwnd;     /* handle of the window */
BOOL fShow;    /* show/hide flag       */
 
The WinShowWindow function sets the window visibility state.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hwnd       Identifies the window whose visibility state is being set.
 
fShow      Identifies the new visibility state. If fShow is TRUE, the
           function sets the window state to visible. If fShow is FALSE, the
           function sets the window state to invisible.
 
Return Value
 
The return value is TRUE if the function is successful or FALSE if an error
occurs.
 
Comments
 
A window possesses a visibility state indicated by the WS_VISIBLE style bit.
When the WS_VISIBLE style bit is set, the window is shown and subsequent
drawing into the window is displayed, as long as the window or any of the
windows in the parent chain have the WS_VISIBLE style.
 
When the WS_VISIBLE style bit is not set, the window is not shown (hidden)
and subsequent drawing into the window is not displayed.
 
If the value of the WS_VISIBLE style bit has been changed, the
WM_WINDOWPOSCHANGED message is sent to the window of the hwnd parameter
before the function returns.
 
Drawing to a window with a WS_VISIBLE style will not be displayed if the
window is covered by other windows or clipped by its parent.
 
See Also
 
WinIsWindowVisible