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.

◄Function Group►  ◄Overview►                          ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINMESSAGEMGR
 
BOOL WinIsWindowVisible(hwnd)
HWND hwnd;    /* handle of the window to test */
 
The WinIsWindowVisible function determines the visibility state of a
window.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hwnd       Identifies the window to test.
 
Return Value
 
The return value is TRUE if the specified window and all its parent windows
have the WS_VISIBLE style bit set. The return value is FALSE if the window
is not visible. Because the return value reflects only the value of the
window's WS_VISIBLE flag, it may be TRUE even if the window is totally
obscured by other windows.
 
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 message
WM_WINDOWPOSCHANGED 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
 
WinIsWindowEnabled, WinShowWindow
 
                                      ♦